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Preface 


This manual is one of a series designed to instruct and guide the programmer in the use 
of the SPERRY UNIVAC Operating System/3 (OS/3). This manual specifically describes 
the OS/3 assembler and its effective use. Its intended audience is the novice programmer 
with a basic knowledge of data processing, but with limited programming experience, and 
the assembler programmer whose experience is limited to non-UNIVAC systems. 


Two other manuals are available that cover OS/3 assembler; one is an introductory 
manual and the other is a programmer reference. The introductory manual briefly 
describes OS/3 assembler and its facilities. The programmer reference provides the 
characteristics of OS/3 assembler in skeletal form and is intended as a quick-reference 
document for the programmer experienced in the use of OS/3 assembler. 


This user guide is divided into the following parts: 
= PART 1. BASIC DATA AND CONVENTIONS 


Introduces you to what basic assembly language (BAL) is, how the computer stores 
information (data), how to locate the data required, and what forms mathematic 
notations assume in computer manipulations. The general rules that a programmer 
must understand to solve simple BAL problems are stated in this part. Where the 
content may seem out of context to the more experienced user, he can find such 
material repeated in greater detail in the following parts of this manual. As the 
manual progresses, the problems and examples become increasingly complex. 


= PART 2. STORAGE AND SYMBOL DEFINITIONS 


Describes and illustrates the use of storage assignments, the constants, and the rules 
for symbol designations. 


m PART 3. BAL APPLICATION INSTRUCTIONS 


Presents the explicit and implicit formats for all the assembly language application 
instructions, the rules of their use and illustrative examples. 


@ m PART 4. BAL DIRECTIVES 


Describes and illustrates the use of all the assembler control directives. 
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=» PART 5. BAL MACROS 





Explains the macro facility for writing and using this time-saving feature of the 
assembler. 


= PART 6. ASSEMBLY LISTING 


Describes what an assembly listing is, what it means, and how it is of use to the 
programmer. 


= PART 7. PROGRAMMING TECHNIQUES 
A series of programming techniques are presented in this part. 
= PART 8. APPENDIXES 


The appendixes contain figures and tables for use in explaining the text and for 
general programmer reference. 


Each of the foregoing parts consists of one or more sections that cover the different 
aspects of the subject matter covered in each part. 
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1. Introduction to Assembler 
Language Programming 


1.1. CODING AN ASSEMBLER PROGRAM 


An assembler language program goes through several transformations before it is actually 
inside the computer and operating (Figure 1—1). The first change is from handwritten 
form to punched card form. This conversion takes code that is decipherable by people and 
changes it to data that can be processed by the computer. Although an assembler source 
program may exist on other media, such as disk or tape, the deck of cards is almost 
always the artifact of the basic assembly language (BAL) programmer. An assembler 
program is built with a punched card deck. 


KEYPUNCH 


HANDWRITTEN SOURCE CODE 


PUNCHED CARD 
SOURCE DECK 











SPERRYSEUNIVAC 
ASSEMBLER CODING FORM 


PROGRAM _ _ 












AOPERATIONA 
10 


1FSAVE START 0 
Pit treodl 














CARD READER COMPUTER 


LISTING 










C9C6E2C1iESC5 E2E3C1D9E3 
OS/3 ASM 


LOC. OBJECTCODE SOURCE 


RESULTS 






OBJECT PROGRAM IN 
EBCDIC HEXADECIMAL 


Figure 1—1. Writing and Submitting a Program 
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The punched card deck is a biform storage medium that is common to the programmer 
and the computer. It contains a copy of a computer program that can be interpreted by 
both man and machine. This is unlike your handwritten program, which can only be 
deciphered by you and is meaningless to a digital computer. The punched card is in a form 
that can be converted to computer data. 


The data converter for the computer is the card reader. It is an electromechanical device 
designed to read information from punched cards by detecting the presence and absence 
of holes in a card. The card reader converts the holes punched in cards on a column-by- 
column basis to data that can be processed by the computer. Each column on a punched 
card is used to represent a single unit of information and the card reader converts each 
column to the character it represents. 


A blank card is shown in Figure 1—2. From this figure, you can see that a card has 80 
vertical columns (numbered at the bottom and near the top of the card) and each column 
has 12 punch positions called rows. Rows O through 9 are numbered on the card, and 12 
and 11 are not numbered; the 12 position is at the top of the card, and the 11 position 
immediately follows it and is before the O row. 











TWELVE PUNCH - ————————————————— 12 
ELEVEN PN —_—_————_—_—o—oO On i 
COODOHHODNGCOKHODDDNNDDODDKHNKHHDHONDADDNHNNNNAAKDHHOHNKHODNOOONDHHDHHDOHOOD 


0 
8 9 10:11 12 13:14 15 16 17 18 19 20 21 22 23 24 3 B27 BBW 3 WS HY BS 4 42 43 44 45 46 47 48 49 50 51 52 53 54.55 56 57 58 59 60 61 62 63 64 65 G6 67 68 ES 70:71 72 73:34:75 76:77 1079 00 
1 


0 
1 
1 DUPED TTTTTTTT ATTA EAT TATA edad 


0 
2 
1 


00000 
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Tidit 
22222222 222222222222222222222222222222222272222222222222 22222222 22222222222222222 
33333333333333333333333333333333333333333333333333333333333333333333333333333333 
BEAM M AAA AAA AAA AAEM AAA AAA A AMAA AMAA AGAAGAAAAAAAAAA AS AGMA AAMAS AAA AAA 
§$555555555555555555555555555555555555555555555555555555555555555555555555555555 
BECEGEEEEGEEEESEEEEEECESCEEEEECEECEE GE SES CEBGECEBEECSEG6GCEE EGE EG G6EEE6 6666 G6E6S 66666 
DUTT DTT TTT TT TAT TTT 99097700 
BESBESKHRBSKESHKEKGHKHKKSKHKGHKEHSKHGSHKGHKGARKKKGKKKKGKKRAREKEKEKAKHBSKKEKHRKHBHBES 


99999999 
12345676 


COLUMN NUMBERS 


Figure 1—2. Punched Card 


Different combinations of holes in a column represent different characters and numbers. 
For instance, each of the decimal numbers O through 9 are represented by the respective 
punch positions on a card. If a column has a hole punched only in row O, then the card 
reader detects a O. If a punch is only in row 1, then the card reader detects a 1, and so on 
through row 9. Everything you code in assembly language is based on the 80-column card. 
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& The cards that make up an assembler language program are punched on a keypunch 
machine from code that is handwritten on an assembler coding form. (The Sperry Univac 
assembler coding form is shown in Figure 1—3.) Each line on the assembler coding form 
has 80 positions that correspond to the 80 columns on a punched card. One card is 
keypunched for every line of code on the assembler coding form (Figure 1—4). The lines of 
code on the assembler coding form and the cards keypunched from the form are called 
source code lines. Collectively, these source lines make a source program. 


A BAL source program is written with instructions, directives, conditional statements, and 
macros. They are the elements of the assembler language and each is usually written on 
one source line. (Sometimes it may take more than one source line to write a single 
element, but most of the time it takes only one source line for one instruction, directive, 
statement, or macro.) The assembler ignores the presence of any blank cards in the source 
deck. A blank line will not be printed nor terminate a sequence of continuation lines. The 
rules for coding assembler language source lines are reflected on the assembler coding 
form. Each source line has five fields and the assembler expects specific information to be 
coded in each field. 


UNIVAC 


SPERRYS> UNIVAC ASSEMBLER CODING FORM =Talel=) 
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LABEL AOPERATIONA 
] 10 16 


IFSAVE START 


\FSAVE START 0 


| 
OMB oof ofooocoocca009 
9 10 H 12 13:14 15 16 17 18 19 29 21 22 23 24 25 26 27 28 
oe) SERRE eee ee eeeee 
222228222222222222222223 
3233333333N33N33333333333333 
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§5595M055555555555555559555 
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ra se a rf oe DD 
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8 

—s3e9999999983993 

123 45 6 7 8 919112 15 4 15 15 17 18 19 
-~0N-5081 





Figure 1—4. Coding Form and Punched Card Relationship 


1.1.1. Operation Field 


The easiest part of an assembler source code line to recognize is the operation field; it 
begins in column 10 and ends in column 14. The operation field is the most restrictive 
field on the coding form because you must use an established operation code. You cannot 
arbitrarily assign a name of your own. The operation code you use is a mnemonic code 
that relates to some function. For example, A is for add, D is for divide, and S is for 
subtract. The mnemonic code must be written exactly as the instruction, directive, or 
statement indicates. For example, A (not AD) causes the add operation to be performed. If 
you put AD in the operation field, the assembler could not relate it to any of the assembler 
functions, so this would cause an error. Each mnemonic code for instructions, directives, 
statements, or macros is listed with the description of that function. The rules for using 
the operation field are: 


1. The operation code must not contain embedded blanks. 


2. The operation code must be written exactly as shown in the list of mnemonics for 
instructions, directives, statements, or macros. 
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3. The operation field must be terminated by a blank. 


4. The operation code must not start in column 1. 





Examples: 
LABEL AOPERATIONA OPE RAND 
1 10 16 
1.] MOVEPAY MVC YEARPAY , WORK 
2.1 MOVEPAY MVC YEAR ,WORK 
3. EOJ 
h, ENJOB 
5. START 6 
6. START @ ~<— 
if USING *,6 
8.) USING *,6 
1. Valid 
2. Invalid because there are embedded blanks in the operation code MVC 
3. Valid 
4. Invalid because there is no such mnemonic as ENJOB 
5. Valid 
6. Invalid because the operation code START is not followed by a blank 
7. Valid 
8. Invalid because the operation code starts in column 1 


1.1.2. Operand Field 


The operand field is the object of the operation code. The operand field begins in column 
16 and ends in column 71. The operand field holds the data or the location of data that is 
being operated on. Each item of data in the operand field is an operand, and operands are 
separated by commas. For instructions, operands can be actual data — like the decimal 
number 10, the name of an area where data is stored — like STORAREA, or the actual 
address specifying the number of bytes the assembler must count to get to the data — like 
1108(32). Operands for instructions, directives, statements, or macros are whatever 
parameters are required by the particular operation that is being done. For instance, an 
add immediate instruction has two operands. The first operand is a main storage location, 
and the second operand is a byte of actual data. An add immediate instruction adds the 
second operand to whatever data is located at the first operand’s address. 


LABEL AOPERATIONA OPERAND 
] 10 16 


Al STORAREA, 18 


The add operation in this example is performed on the actual data, 10, and on whatever 
data is located at an area named STORAREA. 
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The rules for using the operand field are: 





1. The operand field is terminated by a blank that is not enclosed by an apostrophe. 


2. Operands may be continued onto the next line by placing a nonblank character in 
column 72. Up to two continuation lines are permitted. Caution should be exercised 
when using a nonblank character in column 72. As shown in the OUTFILE DTFMT 
example (1.1.7), a comma must follow the last operand on the continued statement if 
there are more operands to follow; otherwise, the operands that follow will be treated 
as comments. 


3. Column 16 is where a continuation line starts. 





Examples: 
LABEL AOPERATIONA OPERAND 
1 10 16 72 
1.) NAME DC CLO'REBEW R D' NAME IN 9 BYTES 
2.| NAME DC CLO'REBEW R D'NAME IN 9 BYTES 
3. ENTRY 1LE,AYAHC NAD,NAHS ,WNS ,WBE ,OREG, 


x< &< 


DNOMYAR ,N4543N11,CONST32,EQUITY,WMC, 
WDR , WRD32 , SGAW 


Valid 
Invalid because the operand field is not terminated by a blank 
Invalid because the line has an embedded blank 





ess 


1.1.3. Label Field 


As we mentioned, the operand field can contain data or the name of an area where data is 
stored. You assign a name to an area in your program by coding a symbolic name in the 
label field of the area to be accessed. Once a source line is given a label, it can be 
referenced from any other location in the source program. For example, | can name a line 
of code and use its name in the operand field of an instruction. 





LABEL AOPERATIONA OPERAND 
| 10 16 

}.] ROUTINE Al STORAREA, 19 

2. B ROUT INE 


In this example, | labeled an add instruction: ROUTINE. Then, later in my program, | used 
the symbol ROUTINE to refer to that line of code. On line 2, | said, ‘“‘Branch to the area 
called ROUTINE, where the add instruction is located.” @ 
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& A symbol in the label field of a line of code can also be used as an operand to reference 
data. For example, | can write a line of code to define a constant. 





LABEL AOPERATIONA OPERAND 
] 10 16 
TEN DC P'ig' 


This line of code says, ‘Place the decimal number 10 in the location named TEN.”’ Once 
the symbol TEN is defined, it can be used as an operand to represent the value 10. 


Al TEN,6 


in this line of coding, I'm requesting that 6 be added to whatever data is stored at location 
TEN. When you label data as | labeled the data (10), you are associating a symbol with a 
value. That symbol can then be used in place of the value. 
The rules for using the label field are: 
© 1. The symbol must start in column 1. 
2. The symbol must begin with an alphabetic character or special letter. 
3. The symbol must not exceed eight characters in length. 
4. The symbol must not contain embedded blanks or other special characters. 


5. The field must be terminated by a blank. 


Examples: 


LABEL AOPERATIONA OPERAND 
1 10 20 





BEGIN 
BEGIN 
WEEKS52 
52WEEKS 
EMPLOYEE 
EMPLOYEENO 
BLANKNO 
BLANK NO 
MOVEPAYMVCYEARPAY ,WORK 


e ° ° s e@ ry 


WON nU SWwh — 
e e 
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1. Valid 
2. Invalid because the symbol does not start in column 1 
3. Valid 
4. Invalid because the symbol starts with a number 
5. Valid 
6. Invalid because the symbol is longer than eight characters 
7. Valid 
8. Invalid because the symbol contains an embedded blank 
9. Invalid because the symbol MOVEPAY is not followed by a blank (There must 


also be a blank after the operation code MVC.) 


The three fields just discussed are essential for designing an executable BAL program. The 
remaining two fields, the comment and sequence fields, don’t play a role in the actual 
design of a program but they are useful programming aids. The comment field is a 
program documentation aid and the sequence field is a program maintenance aid. Program 
documentation is as important to the programmer writing the program as it is to those 
who must refer to it later. Operand specification is usually completed by column 40, thus 
leaving columns 41 through 71 free for comments. 


1.1.4. Comments Field 


There are two ways to code comments: 





1. Comments can be coded on the same line as an instruction, statement, or directive. cs) 
There must be at least one blank between the end of the operand specification and 
the start of comments. If your comments exceed one source line, place a nonblank 
character in column 72 and continue the remaining comments on the next source 
line (at column 16). 


Examples: 

LABEL AOPERATIONA OPERAND ACOMMENTS 

| 10 16 72 
OPEN CARDFLE, PRINT OPEN FILES 
BALR 14,HDRTN GO TO HEADING ROUTINE 

READCARD GET CARDFLE , CARWORK READ A CARD INTO WORKAREA 
MVI PRINTOUT,C' ! CLEAR PRINT AREA 
MVC PRINTOUT+1 (131) ,PRINTOUT 
CLC NUMBERIN(5) ,CUSTNO 1S THE CUSTOMER NUMBER DIFFERENX 


T THAN THE PREVIOUS NUMBER 
BNE NEWCUST 
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2. Comments can be coded on a separate line. This is done by placing an asterisk (*) in 
column 1 of a source line followed by at least one blank space. Then your comments 
can be coded. If your comments exceed one full source line, place another asterisk in 
column 1 of the next source line followed by at least one blank and continue coding 
the remaining comments. Note that a nonblank character is not coded in column 72 
for continuation when an asterisk is coded in column 1 of the next source line. 
However, if your comments exceed one full source line, you can code a nonblank 
character in column 72 if you continue the remaining comments on the next source 
line starting in column 16. An asterisk must not be coded in column 1. 


Example: 
LABEL AOPERATIONA OPERAND 
] 10 16 
BALR 4g 
USING *,4 
OPEN CARDS IN ,PRINTOUT 


* THIS PROGRAM PREPARES AN ACCOUNTS RECEIVABLE REPORT USING CARD INPUT 
* AND PRINTER OUTPUT 


During assembly, comments are printed but do not affect the resulting object code. The 
purpose of comments is to make the program listing easier to follow and can also highlight 
certain portions of the program. 


1.1.5. Sequence Numbers 


Columns 73 through 80 may be used for entering sequence numbers. This is done by 
assigning consecutive numbers to each line of coding and is useful for reassembling the 
card deck, if it should be dropped. It is good practice to number the lines in multiples of 
10, or even 100. This allows you to insert additional coding lines without having to 
renumber the cards when they have been keypunched prior to the modification. Some 
programmers use letters in addition to the numbers. This is useful in identifying the deck 
from which cards have come if they have been removed for any reason. Sequence 
numbers also are important in maintaining a source module. A copy of your source 
module may be stored on tape or disk, and the OS/3 librarian can update and correct the 
source module by using the sequence numbers. (See the current version of the system 
service programs (SSP) user guide, UP-8062.) 
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1.1.6. Column 72 


Another coding feature on the assembler coding form is column 72. This column separates 
the sequence field from the rest of the source line and is normally blank unless you have 
to continue an operand field to the next source line. If an operand specification is too 
lengthy to fit into the columns provided on a single line, the field may be continued onto 
the next line. An operand field can be continued by coding any nonblank character in 
column 72 and then continuing the operands on the next line starting in column 16. It is 
best to avoid using the comma as a continuation character when the comma is being used 
to separate the operand fields. However, it can be used as a continuation character when 
it is being used to separate operands. If you have coded up to column 72 and the next 
character you have to code is a comma separating operands, that comma must appear in 
column 16 of the next line after you code a nonblank character in column 72 (even 
another comma may be used). 


1.1.7. Additional Coding Rules 


The operand fields of an instruction, directive, or conditional statement must completely fill 
all available space on a source line, starting with the first operand specified up to and 
including column 71. Then a nonblank character can be placed in column 72 and the 
remainder of the operand field can be continued onto the next source line (column 16). 
These operand fields in an instruction or directive can be continued for only two additional 
lines. 











Example: 
LABEL AOPERATIONA OPERAND 
] 10 16 72 
TITLE DC C'UNITED STATES GOVERNMENT PRINTING OFFICE STYLE MANUALSX 
(ABRIDGED) ! 
ENTRY 11234567, 31234567 ,K1234567 ,L1234567,M1234567 ,N1234567,01X 
234567 


The operand fields of macros and procs can be coded in two different ways: 


1. The operand fields can be coded in the same manner as instructions, directives, or 
conditional statements, in which case they must completely fill all available space on 
a source line, starting with the first operand specified up to and including column 71. 
Then a nonblank character can be placed in column 72 and the remainder of the 
operand field can be continued onto the next source line (column 16). 


2. The operand fields can be coded to leave space between the last operand specified on 
that line and the nonblank character in column 72. A comma must be placed 
immediately following the last operand on that line, thereby separating it from the 
following operand field on the next source line. However, if you omit the comma 
immediately following the last operand on that line, and at least one blank exists 
between the last operand and the nonblank character in column 72, a warning 
message is issued by the assembler. 
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& The operand fields in a macro or proc can be continued for as many lines as necessary. 


Examples: 
LABEL AOPERATIONA OPERAND ACOMMENTS 
1 10 16 72 
OUTFILE DTFMT | OAREA1=OUTBUF , BLKS | ZE=64@ , RECFORM=VARBLK,S AVAREA=COMMON X 


, VARBLD= (13) , }OREG=(12) , TYPEFLE=OUTPUT 


OUTFILE DTFMT |OAREA]=OUTBUF, 
BLKS1ZE=64¢, 
RECFORM=VARBLK, 
SAVAREA=COMMON , 
VARBLD=(13) , 
1OREG=(12), 
TYPEFLE=OUTPUT 


<< KOK OK 


It is wise to develop good coding habits from the start. A neatly coded program is easy to 
keypunch, debug, and interpret. Figure 1—5 is an example of such a program. This 
example program follows the format of the coding form, has plenty of comments, and uses 
sequence numbers. Don’t fall into the bad habit of jotting down instructions and 
keypunching and assembling them just to see if your ideas have any substance. It is much 
better to sit down and evaluate the problem. First flowchart your program, and then code it 
on the coding form, using plenty of comments and sequence numbers for lengthy 





programs. 
LABEL AOPERATIONAS OPE RAND ACOMMENTS 
1 10 16 72 80 
TITLE ‘FIRST PROBLEM PROGRAM! DARGS186 
PROG] START Gg DAROO26B 
BEGIN BALR 6,0 DAR6O366 
USING *,6 DAROB4 G9 
ZAP WORKAREA, BONUS ENTERS BONUS RATE INTO WORKAREA DAR##566 
MP WORKAREA , WEEKS MULT BONUS BY 52 WEEKS DARDH686 
AP WORKAREA, YEARRATE ADD BONUS TO YEARLY RATE DAR#B7 26 
MOVEPAY MVC YEARPAY , WORKAREA+2 MOVE TOTAL YEARLY PAY DARBS8 90 
DP WORKAREA,WEEKS DIVIDE TOTAL PAY BY 52 WEEKS DAROSI9BS 
MVC WEEKPAY , WORKAREA+1 MOVE WEEKLY PAY,HOURLY RATE 1S DAR#1669 
* NOT CALCULATED IN THIS PROGRAM DAR#116¢ 
MVC OUTPUT (29) , EMPLOYEE COMPLETE RECORD MOVED DAR#1266 
EOJ END OF JOB DARG1 366 
WORKAREA DS CL6 RESERVE 6 BYTES OF STORAGE DARO1 EBD 
BONUS oc PL2'586' PACKED VALUE OF 588 IN 2 BYTES DAR#1569 
WEEKS oc PL2'52! PACKED VALUE OF 52 IN 2 BYTES DARG166¢ 
YEARRATE DC PL4' 1396080! PACKED 1360660 IN 4 BYTES DARG1780 
OUTPUT DC 23C'At 23 BYTES OF BLANKS DARO180¢ 
EMPLOYEE DS OCL23 SYMBOL FOR NEXT 23 BYTES DARB1 98% 
NAME DC CL9'REBEWARAD' REBEWARAD IN 9 BYTES DARO2998 
WORKNO DC C'A1234 Al234 IN 5 BYTES DARB2 168 
YEARPAY DC PLUG! 4 BYTES OF PACK ZEROS DARG2268 
WEEKPAY DC PL3'S' 3 BYTES OF PACKED ZEROS DARO2368 
cG DC C'AdA! 3 BYTES OF BLANKS DARD2469 
END BEGIN END OF THE PROGRAM DAR62568 


Figure 1-5. Example of Proper Coding Techniques 
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You can, if you wish, code your assembler program in a free-form manner. The operation, 
operand, and comments fields don’t always have to start in column 10, column 16, and 
column 41. These columns are shown on the coding form as preferred starting positions 
for each field to promote formalized coding practices. One unbreakable rule is that label 
field must always start in column 1. Each field after the label field must be separated by at 
least one blank. So, if you only have a 3- character label, the operation field can be coded 
starting in column 5 instead of column 10. Also note that the label, operation, and 
operand fields must all be keypunched on the same card. Another restriction is that the 
sequence numbers must always appear in columns 73 through 80. Some examples of 
free-form coding are as follows: 





LABEL AQPERATIONA OPERAND ACOMMENTS 

} 10 16 72 80 

TAG START 8 DARGH1 OO 
BEGIN BALR 6,8 DARG6266 
USING *,6 DARBH308 
ZAP WORKAREA,BONUS ENTERS BONUS RATE INTO WORKAREA DARGB4 06 
MP WORKAREA,WEEKS, MULT BONUS BY 52 WEEKS DARGS566 


As you can see, the free-form style of coding is much more difficult to interpret than the 
formalized style. 


Another option is available, if the location of the fields on the supplied coding form doesn’t 
suit your particular application. The assembler coding form can be changed by using the 
ICTL directive (21.2). By using this directive, you can change the location of the beginning, 
ending, or continuation column. 


After a BAL source program is coded and keypunched, it must first be assembled (and also 
linked) before the program can be executed by the computer. These two functions are 
separate operations and therefore they happen at different times under control of two 
different computer elements. At assembly time, the assembler translates the source 
program to machine code instructions, and at execution time, the hardware processor 
performs the machine code instructions. Although you can interpret a source program as if 
it can actually execute, the hardware processor is incapable of actually executing this 
source program. 


1.2. ASSEMBLING A PROGRAM 


Before source code can be executed by a computer, it must be converted to machine code. 
A BAL source program is converted by an assembler, and a higher-level language, like 
COBOL or FORTRAN, is converted by a compiler. Whether a source program is assembled 
or compiled, the output is always the same. An assembler or compiler produces an object 
program (machine code): 











ASSEMBLER 
OR 
COMPILER 






OBJECT PROGRAM 





SOURCE PROGRAM 
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& The object program is a binary program that can actuate the electronic logic circuits in the 
hardware processor to perform specific functions like add, subtract, or divide. Any 


computer program must be in binary form before it can be stored in the computer and 
executed by the processor. 


Though an assembler or compiler can produce an object program, each operates 
differently. Figure 1—6 shows five source lines from a COBOL program, and Figure 1—7 
shows the object source code generated from the original COBOL source lines. As you can 
see from Figure 1—7, a single compiler source line produces several object code 
instructions. This is not true of assembler source lines (excluding macro instructions); each 
line is converted to object code on a one-for-one basis. The object code shown in Figure 
1—7 is in hexadecimal as is any object code shown in printout form. This is because 
hexadecimal is easier to read and binary would take up too much room on a printout. 


1 INF Sing SFG. Snugcr STATEMENT TDENe 


nonea ANGNL9 PROCEDURE CrVEStaNes PROGUIL 
nnee9 O4020 INITIALIZE. PROGUIL 
nongea o4a021 OPEN INPUT COS.6 PROGGI 
NANCY "4022 OPEN SuUTPUT NEYEIL. LISTe PROGOI] 


NIINg? mO04023 MOVE SpaCFS TO OUT. PROGO?! 





© Figure 1—6. COBOL Source Code 
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NNOFKS 
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Figure 1—7. Object Code Generated from COBOL Source Code 


The assembler converts each source instruction directly to a line of object code. Figure 
1—8 shows a listing of an assembler program. The source code that was submitted to the 
assembler is shown at the right of the listing, and the object code generated by the 
assembler is shown at the left of the listing. Figure 1—8 has a BALR assembler 
instruction in the second source line that uses register 6 in operand 1 and register O in 
operand 2. As you can see, in the object code part of this listing, the assembler has 

@ converted the BALR source instruction to 0560,,. The 05,, is the machine code for a 
branch and link instruction; when the processor reads an 05j.¢, it will perform the BALR 
instruction. For a listing of the machine codes for all instruction op codes, see Table E—1. 
The register numbers for the BALR source instruction are in the second half of the object 
instruction. 
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Figure 1—8. Assembly Listing 
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Very rarely will high-level language programmers read object code. Their concern is mostly 
with the language and the compiler. While assembler language programmers not only 
have the assembler and the assembler language to contend with, they also, if not just by 
sheer exposure, have to tolerate reading object code. This is because the assembler is 
really only one language step from the hardware processor. The only programming 
language left after assembler language is the nonsymbolic machine language. Although 
assembler language is closely related to the processor, it is still a symbolic programming 
language. 


The symbolic language for the assembler has two basic types of operation codes. Those 
that are translated directly to machine codes and those that are not. The mnemonic codes 
that aren't translated to machine codes are processed only at assembly time and do not 
become part of the object program. Nonmachine code mnemonics are used to direct the 
assembler when building an object program, while machine code mnemonics make up the 
actual object program. Operations codes that are translated to machine codes are called 
assembler instructions. For a complete listing of mnemonic instruction codes and their 
counterpart machine codes, see Table E—1. 


There are three categories of nonmachine code mnemonics in the OS/3 assembler 
language: directives, conditional statements, and macros. Table 15—1 is a summary of 
assembler directives; Table 27—1 is a summary of conditional statements; and information 
on the macro instructions available under OS/3 is included in the applicable user guide or 
programmer reference. The most commonly used macro instructions are data management 
and supervisor. See the data management user guide, UP-8068 (current version); data 
management programmer reference, UP-8159 (current version); supervisor user guide, UP- 
8075 (current version); and supervisor programmer reference, UP-8241 (current version). 
The following listing shows the four elements of the assembler language and whether or 
not they are converted to executable code. 


1. Instructions Machine Codes/Executable Code 

2. Directives 

3. Conditional stamens Nonmachine Codes/Nonexecutable Code 
4. Macros 


As stated, the main function of the assembler is to produce an object program from a BAL 
source program. The object program created by the OS/3 assembler is called an object 
module and contains other information in addition to the machine code instructions 
translated from your source program. This other information is generated by the assembler | 
so that OS/3 can recognize and process the object module. Figure 1—9 shows the format 
of the OS/3 object module. The shaded area indicates where the machine code program is 
located in the generated object module, and the remaining unshaded areas in the object 
module are used by the linkage editor, which is an OS/3 system program that creates 
another module called a load module. For further details about the contents of an object 
module, see the system service programs (SSP) user guide, UP-8062 (current version). 
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OBJECT MODULE HEADER RECORD 


LINKAGE EDITOR CONTROL STATEMENTS 
(OPTIONAL) 


CONTROL SECTION RECORDS 


EXTERNAL SYMBOL DICTIONARY (ESD) 
RECORDS (OPTIONAL) 


TEXT/RELOCATION LIST DICTIONARY 
RECORDS 


TRANSFER RECORD 


LINKAGE EDITOR CONTROL STATEMENTS 
(OPTIONAL) 





MACHINE CODE 


Figure 1—9. OS/3 Object Module Format 


1.3. CREATING A LOAD MODULE 


Assembling a program is only the first step in generating an executable BAL program. The 
complete process is a 3-step sequence and is generally called an assemble, link, and go 
operation. This means you must assemble an object module and create (link) a load 
module before you can execute (go) a BAL program. To set up an assemble, link, and go 
operation, or an assemble only (if only an assembly is required), you must use job control 
statements. Section 29 gives detailed information on how to run a BAL job. 


Although the object module created by the assembler contains a BAL program in machine 
code form, it still isn’t an executable program. To be executable (in OS/3) the object 
module must be changed to a load module. After an object module is generated, the 
assembler is no longer in control and the object module, left behind by the assembler, is 
used as input for creating a load module. The next OS/3 system program to gain control 
builds a load module from the object module. This system program is called the linkage 
editor. 


The format of the load module produced by the linkage editor is illustrated in Figure 1—10. 
The shaded area indicates where the machine code program is located in the load module. 
For detailed information about the contents of a load module see the system service 
programs (SSP) user guide, UP-8062 (current version). Segments phase 1 through phase n 
shown in Figure 1—10 aren't created unless you specifically do so with linkage editor 
control statements. However, every load module will always have a root phase. After a 
load module is created, the BAL program is ready for execution. 
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1.4. PROGRAM EXECUTION 


During the assemble and link phase, each type of BAL module is on disk, while during the 
program execution phase, the machine program is stored in main storage as a load 
module. Figure 1—11 shows the location of each module after assembly time and linkage 
editor time. The source, object, and load modules are stored in a disk file called the job's 
run library file (SYSRUN). This file is an OS/3 system file, which is used to hold each BAL 
module until the assembler, link, and go job is finished. 


The focal point of program execution is main storage. Once the load module is loaded from 
disk to main storage, the machine instructions are fetched one at a time from main 
storage by the processor. When the processor fetches an instruction, the op code is 
decoded to find out which instruction is to be executed. If the instruction is legal, it is 
executed and the processor fetches another. This goes on until no machine instructions 
are left in the load module. 


The only codes that the processor can interpret are the machine codes for assembler 
instructions. Any other codes submitted to the processor will cause an error, and the 
offending program is aborted. Every machine code instruction in the BAL instruction 
repertoire is Supported by the micro code loaded into the control storage of the system. It 
is important to realize that machine codes, and only machine codes, can drive the 
hardware processor. This is the key to understanding the difference between program 
execution time and assembly time. At assembly time, the assembler processes the source 
program; the processor cannot execute a source program and doesn’t see your program 
until it is in machine code form. 
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PHASE HEADER RECORD 





AUTOMATICALLY INCLUDED ONLY PRESENT IF REQUIRED 
OBJECT CODE AND AUTOMATIC INCLUSION 
FEATURE IS NOT INHIBITED 
AUTOMATIC OVERLAY CONTROL ROUTINE ONLY PRESENT WHEN V-CON 
{KLSOCP OR KLSOCPR) PROCESSING IS SPECIFIED 
ROOT AND VALID V-CON 
PHASE REFERENCES EXIST IN 
SEGMENT MULTIPHASE OR MULTI- 
REGION LOAD MODULES 
REGION TABLE (RTAB) 
SPECIFICALLY INCLUDED 
OBJECT CODE 
TRANSFER RECORD 
PHASE HEADER RECORD 
PHASE 1 SPECIFICALLY INCLUDED 
SEGMENT OBJECT CODE 
TRANSFER RECORD 
PHASE HEADER RECORD 
PHASE N SPECIFICALLY INCLUDED 
SEGMENT OBJECT CODE 
(UP TO 99) 


TRANSFER RECORD 





MACHINE CODE 


Figure 1—10. OS/3 Load Module Format 
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Figure 1—11. Assemble, Link, and Go Operation 
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2. Data Forms 


2.1. DATA REPRESENTATION 


Computer data is stored in special code combinations used to represent all the characters 
and numerical data needed for problem solving. The smallest area the computer can move 
or manipulate is called a byte, which is composed of eight units called bits. Each bit is 
either a 1 or a O; thus, a byte representing the letter M would look like this: 


1 BYTE 





Bits are numbered from left to right, with the leftmost bit referred to as the zero bit or the 
most significant bit (MSB). The rightmost bit in this byte is the number seven bit. The 
rightmost bit in any field, no matter how long, is also referred to as the least significant bit 
(LSB). Two contiguous bytes are called a half word; four are called a full word; and eight 
are a double word. When you manipulate several bytes as a string, the leftmost byte is 
called the most significant byte (MSB), and the rightmost byte is the least significant byte 
(LSB). Additional information on bit and byte structure is given in 4.3.2. 


Table 2—1 comprises different methods of organizing and referencing numeric data as you 
would use them in data processing. 
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Table 2—1. Comparison of Numeric Expressions 


Decimal 
Examples 
ee ia eee 


Character form (unpacked) 
Zoned decimal (+) 
Zoned decimal! (—) 


Packed decimal (+ only) 


Packed decimal!, signed (+) 


Packed decimal, signed (—) 


Hexadecimal (+ only) 


nm 
E~y 


Floating point (+) +500 


py 
nea 

oO 

° 


—500 


n 
> 


Floating point (—) 


oO 
Oo 
oO 


t 
Binary (+ only) 0000 ! 0001 1111. 1 0100 +500 


Binary (+ only) 0000 | 1100 +65,036 
Fixed point (+) 0000 | 0001 +500 


Fixed point (—) 0000 |} 1100 —500 





2.2. BINARY REPRESENTATION 


In binary language, the same principles are followed as in decimal language. In decimal 
language (base 10), the number 251 is a combination of three values: 


a value of one unit 


the value of five 10’s 








the value of two 100’s 


In binary (base 2), the rightmost digit has the decimal value of 1; the digit to its left has a 
decimal value of 2, the next is 4, then 8, and so on to the most significant bit, which in 
one byte, has the decimal value of 128. You determine the total value of a binary number 
by adding the decimal! value of each “on” bit (1), as illustrated in Figure 2—1. 
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@ 2 
0 oe) 0190 Oo =6060O0 1 This has a decimal! value of 1. 
4 1 
0 0 0 01,0 1 0 1 This equals the sum of 4 and 1 (or 5). 
8 4 2 
0 0 0 011 1 1 0 This equals the sum or 8, 4, and 2 (or 14). 


This decimal value adds to 255, which is the maximum 
value for one byte. The maximum value for a half byte 
(4 bits) is 15. 





& ‘ Figure 2—1. Determining Binary Values 


Starting with the value of zero, a full byte represents a total of 256 different codes (B.1) 
and a half byte represents 16 codes. Since binary notation is unwieldy, most notations are 
written and computer-printed in other forms. 


2.3. HEXADECIMAL REPRESENTATION 

Using base 16 values, there are 256 hexadecimal codes in one byte. The hexadecimal 
notations consist of the numbers O through 9 and the letters A through F. In this way, we 
can represent the maximum decimal value of a half byte, which is 15, by one hexadecimal 
notation, which is F (Table 2—2). In B.1, the relationship of the binary, decimal, and 


hexadecimal codes for a full byte is shown. 


Hexadecimal representation is an outgrowth of decimal and binary representation of data. 
In decimal, the base used is 10; therefore, the decimal number 251 is in actuality: 


25 1 


Ae 


2x 107+5x10'+1x 10° 


which is the same as saying: 


i) (2 x 100) + (5 x 10) + (1 x 1) = 251 





UP-8061 Rev. 3 SPERRY UNIVAC OS/3 2-4 
ASSEMBLER 





If we take this same number, 251, and show it in binary notation (that is, use the base 2), 


it would look like this for one byte: 


This is the same as: 

(1 x 27) + (1 x 26) + (1 x 25) + (1 x 24) + (1 x 23) + (O x 22) + (1 x 2') + (1 x 29) 
or: 

(1 x 128) + (1 x 64) + (1 x 32) + (1 x 16) + (1 x 8) + (Ox 4) + (1 x 2) + (1x 1) = 251 


Hexadecimal notation reduces the time and space needed to read or write the codes 
represented by a full byte of binary information. Because 16 is the base, to convert binary 
data to hexadecimal data, divide the binary representation of the decimal number into 
groups of four bits and pad to the left as necessary to obtain a full grouping of four bits. 
Thus, taking the binary representation of the decimal number 251 and breaking it up into 
groups as just described, we get: 





Binary = decimal value 251 
(15 x 16")+ (11x 16°) 

Decimal = decimal value 251 

Hexadecimal F!B = decimal value 251 


Table 2—2, Hexadecimal Notation 


Binary Decimal Hexadecimal 
Half Byte Value Code 













DOAN OOF WHY - CO 


rMVWOA WYP OWN AOA PWH H- OC 
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2.4. CHARACTER REPRESENTATION 
There are 256 possible bit combinations that can be stored in a byte. By convention, 
certain bit combinations are used to represent the letters, numerics, and special 
characters that are used to convey information in written form. In B.1 are listed the 
hexadecimal equivalents of the characters used to write programs. It is also pointed out in 
this document that only certain characters are used in statement formats. To aid in the 
specification of permissible characters, the overall character set of the assembler is 
divided into the following classes: 
= Alphabetic set: 

— Alphabetic characters: the uppercase letters A through Z 

— Special letters: ? $ # @ 


. Numeric characters: O through 9 


a Special characters: + - * / , = A (blank)().&'>< 


2.4.1. Alphabetic Characters 
The letters A through Z are alphabetic characters and part of the alphabetic set. The 


following table shows the hexadecimal representation, which is one byte long, for each of 
the uppercase letters. (Also see B.2.) 


Alphabetic Hexadecimal Alphabetic Hexadecimal 
Character (EBCDIC) Code Character (EBCDIC) Code 
ci D5 


C2 
C3 











D6 
D7 


ZrArAcT- TH rMIOVBD DY 
N<XS<CcCHAWNDOVOZ 
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2.4.2. Special Letters 
The following special letters are part of the alphabetic set and usually follow the same 


rules as the letters mentioned in 2.4.1. The hexadecimal representation for these special 
letters are listed in the following table (also see B.2): 


Special Hexadecimal 
Letters (EBCDIC) Code 
6F 


? 
$ 
# 
@ 





2.4.3. Numeric 


As previously noted, all characters are coded in a full byte (eight bits), and this is also true 
for the character forms (unpacked) of numbers. Numbers written in this form, just as 
letters and other characters, can be moved from one location in main storage to another 
and can be sequenced, compared, and treated in other ways; but mathematica! operations 
can not be performed on unpacked numerics. To do mathematical operations, the values 
must be in binary or packed decimal form. Unpacked and packed numeric formats are 
explained in 2.4.3.1 and 2.4.3.2. All numeric forms are shown in Extended Binary-Coded 
Decimal Interchange Code (EBCDIC). For the American Standard Code for Information 
interchange (ASCII), see B.3. 


2.4.3.1. Unpacked Format 


Unpacked (printable) numeric characters are coded in a full byte and are easily recognized 
because the first half of the coded byte is the hexadecimal code F. The decimal! digit 5 is 
represented in a byte as F5. The F half of the byte (bits O through 3) is the zone field, and 
the 5 (bits 4 through 7) is in the digit field. Numeric data must be in this unpacked format 
to be output to a printer unit. 
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é& The following shows the hexadecimal 1-byte unpacked code for each decimal digit. 


Hexadecimal 
(EBCDIC) Code 


Decimal 
Digit 






ee 





Examples of decimal digits and their unpacked byte equivalents are shown here. 


52 fills 2 bytes Fis Fbied 
107 fills 3 bytes F!li FIotFi?7 
! 


0024 fills 4 bytes FIOJFLiO}Fi2]/Fl4 


@ 2.4.3.2. Packed Format 


As you can see, unpacked format involves a considerable waste of main storage space. 
When numbers are to be processed, they can be converted to packed format by means of 
the PACK instruction, prior to processing. In packed format, the zone fields are stripped 
away and the number is stored as follows: 


byte 1 





Thus, in packed format, only two bytes are needed to store the decimal number 107. This 
results in considerable savings in main storage space. After mathematical operations on a 
packed number, the sign C indicates a positive value and the sign D a negative value in 
EBCDIC. 


710 —107 (signed) 


7 IVF unsigned (assumed positive) 


p10 | 71C +107 (signed) 
1/10 
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The following program extract shows how the PACK instruction is used. (See 9.7.) 


PACK AREA1,NO1 Area NO11 is packed into AREA1. 
AP AREA1,ONE A sign code is produced. 

NO1 DC C'123' 

AREA1 DS CL2 

ONE DC PL’1’ 


After these operations, the two main storage areas will look like this: 


NO1 Fi1ry]/Fl2a2]ri3 


AREAt Ph2 4'tc 


The hexadecimal code C in AREA1 indicates that the value is positive. If the value is to be 
indicated as a negative value, a hexadecimal code of D would be in this field. 


2.4.4. Special Characters 


The following 14 special characters are not part of the alphabetic set (2.4.1), special letters 
(2.4.2), nor are they numeric (2.4.3). They have special uses, and rules are covered in this 
user guide when required. Following are listed the special characters with their 


hexadecimal codes for reference. (Also see B.2.) 
Special Hexadecimal Special Hexadecimal 
Character (EBCDIC) Code Character (EBCDIC) Code 
+ 4E 4D 


( left 
parenthesis 






























- (minus) ) right 5D 
parenthesis 

‘ . (period) 

/ & 

, (comma) ” (prime) 

= > 





A (blank) < 
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2.5. FIXED-POINT NUMBERS 


Each fixed-point number is represented in one of three fixed-length binary formats 
composed of a single positive or negative sign bit followed by a number field (Figure 2-2). 
When the sign bit is 0, the number represents a positive value; when 1, the number 
represents a negative value. Negative numbers are represented in twos complement 
notation, which is derived by inverting each bit of the binary number and adding 1 to the 
result of the inversion. For additional information on fixed-point numbers, see 2.1, 5.2.6, 
5.2.7, and Section 10. 


HALF WORD 


5 

I 

N NUMBER FIELD 

o|1 15 


FULL WORD 


NUMBER FIELD 





DOUBLE WORD 


Figure 2—2. Fixed-Point Number Formats 


2.6. FLOATING-POINT NUMBERS 
The assembler provides floating-point arithmetic operations as an optional hardware 
feature. Floating-point arithmetic operations involve a fraction and an exponent. For 
example: 

217,000 can be expressed as 0.217 x 108 

296,000 can be expressed as 0.296 x 108 
In fixed-point arithmetic, add: 

217,000 
+ 296,000 


513,000 
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In floating-point arithmetic, add: 





0.217 x 108 
+ 0.296 x 108 
0.513 x 108 

where: 


0.513 is the fraction and 108 is the exponent. 


In floating-point notation, the fraction is added and the exponent is retained. The example 
uses decimal floating-point; the assembler uses hexadecimal floating-point. In hexadecimal 
floating-point notation, the biased exponent is expressed in excess-64 binary notation; the 
fraction is expressed as a hexadecimal number having an arithmetic point to the left of the 
most significant digit. The quantity expressed by the full floating-point number is the 
product of the fraction and the number 16 raised to the power minus 64 of the biased 
exponent (fraction x 16°64), For additional information on floating-point numbers, see 
5.2.12 and Section 11. 


characteristic mantissa 


(exponent) (fraction) 
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3. Addressing 


Each full byte (eight bits) of main storage is numbered in sequence starting with OOOOOO. 
With the assembler, the address of each instruction is calculated and you can refer to it by 
its real address or by a symbolic notation assigned to it. The assembly listing shows these 
addresses in their hexadecimal form. The computer also contains 16 registers that can be 
used for addressing and storage. The many types and uses of addressing are covered in 
detail in the following parts of this user guide. 


3.1. MAIN COMPUTER STORAGE ADDRESSING 


If you wish to refer to some other part of your program, you assign a symbol to that 
location and the assembler translates this to the real main storage address. 


3.1.1. Instruction Addressing 


Your program may contain the move instruction MVC: 





LABEL AOPERATIONA OPERAND 
| 10 16 
MOVES MVC MYAREA, YOURAREA 


Even though the main storage for this application instruction is OOOO8A, you could return 
(branch) to this instruction by writing: 


B MOVE5 


This type of referencing a location in a program is called symbolic addressing. It is a time 
saver and helps eliminate many errors. 
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3.1.2. Data Field Addressing 
As noted in 1.2, storage and data areas are defined for later reference. The following list 


shows assembler-generated addresses, the symbolic addresses assigned by you, and the 
storage areas. 


Assembler-Generated |= Symbolic 


Address Address Definition 
000048 WKAREA1 DS CL41 
000071 WKAREA2 DS CL16 
000081 MYAREA DS OCL121 
000081 OUTPUT 1 DS OCL121 
000081 NEWAREA1 DS CL41 
OOOO0AA NEWAREA2 DS CL80 
OOOOFA YOURAREA DS OCL121 
OOOOFA INPUT1 DS OCL121 
OOOOFA COUNTS DS OCL3 
OOOOFA COUNTS DC CL1‘5’ 
OOOOFB COUNT12 DC CL2°12’ 
OOOOFD DS CL118 


The first work area shown, WKAREA1, has the hexadecimal location 000048 and is 41 
bytes long. The hexadecimal value of 41 is 29, which added in hexadecimal produces the 
next hexadecimal location 000071. The next areas, MYAREA and OUTPUT1, show how we 
can assign different symbols to the same area. They do not take up main storage space 
and thus have the same address as NEWAREA1, which is 16 bytes from the start of the 
last address. The hexadecimal value of 16 is 10; thus, the address of NEWAREA‘1 is 
000081. This address plus 41 bytes (hexadecimal 29) produces the next address, OOOOAA. 


The use of either the symbol MYAREA or OUTPUT1 calls for the same 121 bytes following 
them in storage. The zero placed in front of the CL instructs the assembler to assign a 
location for these symbols but not to reserve any storage for them. The remaining six 
instructions show how this can be done with constants (DC) as well. The symbol COUNTS 
is an example of a symbol reference within another symbol reference. 
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3.2. REGISTER ADDRESSING 


There are 16 general registers (O through 15). Each register consists of 32 bits which is 
equivalent to a fullword. Any register can be used in RR, RS, or RX type instructions. Any 
register can also be used in base register assignment. However, most I/O operations use 
registers 14, 15, 0, and 1. So, if you use any one of these registers and then perform 
either input or output, the original data in these registers is destroyed. You can use these 
registers, though, by saving their contents prior to the execution of an |1/O operation and 
restoring their contents after the execution of an I/O operation. 
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4. Rules and Conventions 


4.1. READING INSTRUCTION NOTATION 

Notations are used throughout this manual to describe the general forms of programmer- 
written and computer-generated formats. A consolidated listing of all the notations is 
included in Figure 7—1. This section includes the definitions of terms. 


4.1.1. Assembler Application Instruction Notations 


There are six forms of assembler applications instructions: 


RR — _ Register-to-Register 

RX — _ Register-to-Indexed-Storage or Storage-to-Indexed-Register 

RS — _ Register-to-Nonindexed-Storage or Storage-to-Nonindexed-Register 
S| — Storage Immediate 

SS — _ Storage-to-Storage (Type $S1) 

SS — _  Storage-to-Storage (Type SS2) 


Assembler application instructions provide the format for hand-written coding that, in turn, 
leads to the assembler format that generates the machine coding. The assembler 
application move instruction (MVC) illustrated is an SS1 type. The coding is described on 
the following page. Definitions of the explicit and implicit formats are provided in Section 
7. 


Explicit Format: 







A OPERATION A OPERAND 


[symbol] d, (I, ,b, ),d, (b,) 
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Implicit Format: 








A OPERATION A OPERAND 


[symbol] 


On the coding sheet, it could look like this: 





LABEL AOPERATIONA OPERAND 
] 10 16 
OUT4 MVC AREA(37) ,NETPAY 
where: 
[symbol] 


The brackets around symbo/ mean OUT4 is optional. 


MVC 
Is the mnemonic opcode for the move instruction. 





AREA(37) 
Is the first operand: d, (,,b,) or s, (I,;) AREA is the address d,(b,) or symbol s, and 
(37) is the length (I,) of the receiving field to be filled. 


NETPAY 
Is the second operand: d,(b2) or So. 


After this application instruction is assembled, it is in the following form: 


opcode d, 
0 7 20 31 
b, d, 
32 3536 47 


And could have the generated machine code: 





D2 24 44FC 4AA6 
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@ where: 


D2 
Is the operation (opcode) for the mnemonic MVC. 


24 
Is the hexadecimal coding for the length (I,), which is 37 bytes long but 
assembled as 37—1 or 36. 


Is the base register b, used for the first operand. 


4FC 
Is the displacement d, used for the first operand. 


4AA6 
Is the base by and displacement d, address of the second operand NETPAY. 


The generated machine code is expressed in hexadecimal form. Knowing the organization 
of the machine code format can help you when the written coding does not generate the 
values you intended. Such knowledge helps in finding errors in the results of a program. 
(See Figure 4—1). 


@ Consider another instruction: 







AOPERATION A OPERAND 


6,GROSSPAY (5) 





[symbol] 


where: 
L 
Is the mnemonic opcode for the load instruction. 
6 
Is the first operand register r,. 
GROSSPAY(5) 


Is the second operand in the form s,(x,). 


After this application instruction is assembled, it may generate the following machine 
code: 


58654012 
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where: 
58 
is the opcode for the load instruction. 
6 
Is the register r,; used for the first operand. 
5 
Is called the index register and is part of the second operand. 
4012 


Is the base b, and displacement d, for the second operand address GROSSPAY. 
For a discussion of how the processor uses the base register, index register, and 
displacement of an operand to form main storage addresses, refer to the current 
version of the processor programmer reference. 


The assembler places the source code, identified by the operand, immediately after the 
COPY directive. This source module may not include any COPY, END, ICTL, MACRO, or 
MEND directives. The last statement in the source module may not be continued into the 
source program being assembled. Statements included in the program by a COPY directive 
are assumed to be in standard format regardless of any ICTL directives in the program. 


Figure 7—1 shows the formats of the six application instructions as generated by the 
assembler in machine code, as well as the explicit and implicit formats for programmer 
coding. Examples of the implicit coding format using symbols and the explicit format are 
included in following sections for each assembler application instruction. More detailed 
information on the use of the assembly listing is in Section 28. 


4.1.2. Notation Rules and Meanings 


The following conventions are used in application-instruction, assembler-directive, macro- 
instruction, proc, and control-statement formats: 


= = Optional information is enclosed in brackets [ ] and may be specified or omitted as in 
the use of [symbol]. 


2 Braces { } indicate multiple options, at least one of which must be chosen, as in the 
following directive. 


For example: 


PRINT fon \ 
OFF 


7 Braces within brackets signify that one of the options must be chosen if that operand 
is specified. 


For example: 


A 
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(symbol 








Instruction opcode 
Format 
Object Code opcode 
Format 0 aie 








a ee 


Source Code gyt4 


Example MVC AREA(37),NETPAY 
Object Code | 
Printout —— 
0003F6 D2 24 44FC 4AA6 
where: 
Q003F6 
Is the address of the instruction symbol, OUT4. 
D2 
ls the numeric operation code for the mnemonic, MVC. 
24 
Is the 37-byte length (I,), value 37—1. 
4 
ls the base register (b,) for the first operand, AREA. 
4FC 
Is the displacement for the first operand, AREA. This displacement plus the contents of the base register yield the 
starting address of the first operand. 
4 and AA6 


Specify the base register and the displacement for the second operand, NETPAY. 


Figure 4—1. Assembler Format Relationships 


= When given a choice of multiple options, the option that is shaded is the default 
option and indicates the choice that will be made by the system if you do not specify 
one of the options. 


For example: 


DATE 
EXT 





PRE 
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. Uppercase letters, terms, and punctuation marks indicate information which must be 
coded exactly as shown. Also, mnemonic codes (such as MVN, PACK, and CLC) are in 
uppercase letters. 


a Lowercase letters and terms indicate variables (such as [symbol], r, d, b, and e) which 
are supplied by you. 


= @An ellipsis, a series of three periods, indicates that a series of entries may be coded, 
as in the directive DROP r,[,ro,...,t]. 


7 Keyword parameters may be coded in any order. 
For example: 


IOROUT=LOAD,BLKSIZE=5 12,RECFORM=FIXBLK 
BLKSIZE=512,IOROUT=LOAD,RECFORM=FIXBLK 


= Positional parameters must be coded in the order shown. Commas are required after 
each positional parameter except the last. When a positional parameter is omitted 
from a series of positional parameters, the comma must be retained to indicate the 
omission. 


For example: 


X‘03’,OUTP,X’00’,132 (operand field of CCW) 
&P,3, &KEY1=, &KEY2=, &KEY3=(operand field of macro statement in proc format) 


2 Names of directives and instructions in text are shown in lowercase italics. 
For example: 
add, move, load, branch and link, store 


= Throughout this manual, the register notations RO through R15 represent the 
registers O through 15. 


For example: 
BALR R2,R3 


The hand-written program, usually on the assembler coding form, is called the source 
program; the keypunched cards containing this coding are still called the source program 
or source cards or source deck. The source program is assembled, and the assembler 
usually produces a translation of the source program into machine code; this deck is called 
the object program. A printed listing of the assembled program, called the assembly listing, 
shows the source coding with its associated assembled machine coding. 


The smallest unit of information in basic assembly language (BAL) is the bit. Eight bits 
make a byte and two bytes form a half word. Four bytes are a full word and eight bytes 
comprise a double word. Figure 4—2 shows the relationships between bits, bytes, and 
words. Bits O through 7 form the high-order byte or MSB, and bits 56 through 63 form the 
low-order byte or LSB in a double-word storage area. 
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DOUBLE WORD 


0101 


1100 


ae | 


0010 1100 
47) 48 


O101 


55/56 


1101 


' 
' 
' 
1 





LSB 


1001 


= 





Figure 4—2. Byte and Word Structure 





The foliowing short definitions should be useful for the new programmer. 


Source program 

Programmer-produced 
Source cards 

Keypunch output 
Source deck 

Keypunch output 
Machine code 

Assembler-generated 
Object program 

Assembler output 
Assembly listing 


Assembler output to printer 


Bit 

One binary digit 
Byte 

Eight binary digits 
Half word 

Two bytes 
Full word 


Four bytes 
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a Double word 





Eight bytes 
= MSB 

Most significant bit or byte, leftmost 
= LSB 

Least significant bit or byte, rightmost 
® High order 

Leftmost data, byte, or bit 
= Low order 


Rightmost data, byte, or bit 


4.2. TERMS 


Terms represent values coded by the programmer or computed by the assembler. There 
are five classes of terms recognized by the assembler: & 





= Self-defining terms (SDT) 

" Literals 

a Symbols 

m Location counter references 

= Length attribute references 

Self-defining terms are fixed values the programmer codes such as 
33,P'591’",X‘OF’,B‘11100110’, or C’EBW’. Literals can have their value specified by the 
programmer and their location decided by the assembler and could look like, 
=X'FO',=C‘A’,=P’—1', or =B’00001000’ as used in storage-to-storage instructions (e.g., 


CLC TAGA,=C’A’). Symbols, location counter references,. and length attribute references 
are assigned values by the assembler. (See Table 4—1.) 
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Table 4—1. Comparison of Terms 


AREA10, 10. 
Can be used in the 1st or 2nd SDT 


Operands. AREAB, X'C2’ 
May be used in application SDT 
instructions and in assembler 33 (10,R5),3(R8) 
directives. SDT SDT SDT 


Literals AREA10,=C’'10' 
a May not be used in assembler Literal 


directives. AREA10,=X'F1F0' 
o Literals are preceded by an Literal 
equal (=) sign. ONSW,=B‘11111111' 
—_——" 
Literal 


Symbols for constants AREA10 DS CL2 

a May be used in the 1st or 2nd NO10 DC C’10’ 
operands. MOVE10 MVC AREA10,NO10 

a May be used in application 
instructions and in assembler 
directives. 


symbols 





4.2.1. Self-Defining Terms (SDT) 


Self-defining terms (SDT) are terms that represent fixed values. They are presented by the 
programmer in a form that is easily recognized and its value is understood without the 
need for computation. SDTs are not relocatable; they can be used to specify immediate 
data, registers, addresses, and masks. They can be used in assembler directives as well as 
in application instructions and can be part of an expression. The size of an SDT depends 
on where it is used. When used to designate a register you cannot exceed a value of 15. 
After conversion by the assembler to a binary format, the value is right-justified and filled 
with binary zeros on the left to fit the designated field. SDTs can be represented in binary, 
hexadecimal, decimal, or character form. (See 5.2.) 


When a 24-bit hexadecimal, binary, or character SDT has a 1 in the sign bit position the 
SDT will be treated as a negative term in the evaluation of an arithmetic expression. 


= A binary SDT consists of a series of up to 24 zeros and ones enclosed in apostrophes 
and preceded by the letter B (e.g., B‘101’,B‘11110000’,B’00101’). The field is filled 
with high order zeros when necessary. 


= A hexadecimal SDT consists of up to six hexadecimal digits enclosed in apostrophes 
and preceded by the letter X (e.g., X‘FO’, X'C1',X’F1FOFO’). Each hexadecimal digit 
represents a half byte of information. 


= A decimal SDT is an unsigned decimal number consisting of up to eight digits having 
a value of O through 16,777,215 (224—1) (e.g., 0, 32, 16000000). This number is 
converted by the assembler to a binary value occupying one, two, or three bytes. 
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= Accharacter SDT consists of up to 3 characters of the 256 valid characters of which 
only 63 are printable. (See Appendix B, Table B—1.) The characters must be enclosed 
in apostrophes and preceded by the letter C (e.g., C‘A’,C’ABC’, C’123’, C’A1’). Each 
ampersand or apostrophe to be included in a character representation must be 
indicated by a double ampersand or double apostrophe, respectively. In this case there 
may be more than three characters within the apostrophes which delimit the SDT 
(e.g., C'3"S’ produces 3°S;C’‘A&&B’ produces A&B). 


The following four examples all produce the same internal bit pattern of 11110001 in the 
one byte area called AREA: 


. Decimal CLI AREA, 241 

: Hexadecimal CLI AREA, X’‘F1’ 

2 Character CLI AREA, C’1’ 

7 Binary CLI AREA, B‘11110001’ 
4.2.2. Literals 


Literals are terms that represent data in the source coding (see 5.3). The assembler 
replaces the value of the original literal in the literal table (pool) with the address of the 
main storage location. In the following example the literal =C’AA’ will be replaced in this 
instruction by the address of a 2-byte area in the literal table containing the binary value 
11000001 11000001. 


MOVEAA MVC TESTSW,=C’AA’ 


When the assembler recognizes a literal in the source code, it searches the table of literals 
that have been previously encountered. If a duplicate is found, then the relocatable 
address of the literal in the table replaces the original literal in the source code. If a 
duplicate is not found, then the value of the original literal is entered into the table and its 
address replaces the source code specification. Literals are similar in form to the operands 
of DC and DS statements. 


A literal may be used in any machine instruction that specifies a storage address, except 
that the literal may not be specified as the receiving field operand of an instruction that 
modifies storage. Literals may not be specified in address constants, shift instructions, or 
1/O instructions. Literals must always appear as the complete operand specification. They 
cannot be combined with other terms, nor with an explicit base register specification. ‘S’ 
type constants may not be used as literals. 
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4.2.3. Symbols 


A symbol is a group of up to eight alphanumeric characters. The left, or leftmost, character 
must be alphabetic. Special characters or blanks may not be contained within a symbol. 
(See Section 6). The following are examples of valid symbols: 


V CARDAREA 
GS$279 RSINTRN 
BOB BD#4 


The following are not valid symbols for the reasons stated: 


READ ONE Embedded blank 
SPEC’L Special character used 
6AGN First character not alphabetic 


Two other categories of symbols are available in the macro language and conditional 
assembly statements. They are variables symbols and sequence symbols. These categories 
of symbols are defined and discussed in detail in Section 6 and in 27.2.1. 


The assembler associates three attributes with each symbol it processes. These attributes 
are value, length, and relocatability. Symbols defined by the EQU directive adopt the 
attributes of the expression in the operand field of the statement. (See Section 16.) 


i] Value Attribute 


A symbol is assigned a value, or defined, when it appears in the label field of any 
source code statement other than a comment. A symbol appearing in the label field of 
an EQU or ORG directive is assigned the value of the expression in the operand field. 
In all other cases the value assigned is the current value of the location counter after 
the adjustment to a_ half-word, full-word, or double-word boundary (5.1.7.),_ if 
necessary. The value is assigned to the current label before the location counter is 
incremented for the next instruction, constant, or storage definition. Thus, if a symbol 
appears in the label field of a statement defining an instruction, constant, or storage 
area, the symbol is assigned a value equal to the storage area address of that 
instruction, constant, or storage area. 


The value of a symbol must lie in the range —2?23 through 228—1. 
= §=Length Attribute 


The length attribute of a symbol is the number of bytes assigned to the instruction, 
constant, or storage area involved. For example, the label of a 2-byte instruction has a 
length attribute of 2 and the label of a DS statement reserving 200 bytes would have 
a length attribute of 200. Symbols equated to location counter references or absolute 
value representations usually have a length attribute of 1. The duplication factor 
(constant or storage area) has no effect on the length attribute. (See 5.1.3.) 


The maximum length attribute that can be generated by the assembler is 65,536. 
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7 Relocatability Attribute 


A symbol may either be absolute or relocatable. Values which are assigned to 
symbols defined in the label field of a source code line representing an instruction, 
constant, or storage definition, are relocatable. A relocatable symbol is a symbol 
whose address would change by a given number of bytes if the program in which it 
appears is relocated the same number of bytes from its originally assigned address. 
Relocatable symbols are assigned values relative to the location counter. Decimal, 
character binary, and hexadecimal representations are all absolute terms and have a 
relocation attribute of O. 


4.2.4. Location Counter References 


A location counter is maintained by the assembler for each control section created by the 
programmer. Each counter contains the next available location for the associated control 
section. After the assembler processes an instruction or constant, it adds the length of the 
instruction or constant processed to the correct location counter. The maximum value that 
the location counter can achieve is 223—1, 


Each instruction must have an address which is a multiple of two bytes. This type of 
address is said to fall on a half-word boundary. If the value of the location counter is not a 
multiple of 2 when assembling such an instruction, a 1 is added to the location counter 
before assigning an address to the current statement. Storage locations reserved in this 
way receive binary O’s when the program is loaded. Certain constants must be aligned to a 
half-word, full-word, or double-word boundary. Again the location counter is adjusted to 
the boundary, and the storage locations which were by-passed receive binary O’s when 
the program is loaded unless the adjustment occurred as a result of a DS or ORG 
directive. 


The current value of the location counter, under which the program is currently being 
assembled, is available for reference by the programmer. It is represented by the special 
asterisk character (*). If the asterisk is written as a term in an address constant or in an 
instruction operand expression, this character is replaced by the storage address of the 
leftmost byte allocated to that instruction or constant. Care must be taken to ensure that 
all such implied references are specified appropriately in individual expressions since the 
character asterisk (*) may also be used to indicate the multiply operator during the 
evaluation of expressions. 


An instruction may address data or other instructions in its immediate vicinity in terms of 
its own storage address. This is one kind of relative addressing and it is achieved by an 
expression of the form *+n or *—n where n is the difference in storage addresses of the 
referencing instruction and the instruction or data being accessed. Relative addressing is 
always in terms of bytes and not in terms of words or instructions. 


A location counter reference may not be made in a statement which requires the use of a 
predefined symbol, with the exception of the EQU and ORG directives. 
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4.2.5. Length Attribute Reference 


The length attribute of a symbol is referenced as a term in an expression by writing L’ 
followed by the symbol. Thus, if the symbol STOREND is the name of a full-word field, 


_ L'STOREND 


would be considered a term and it would have a value of 4. (See 5.1.5.) 


4.3. OPERATORS 


There are 12 operators in the assembler language (Table 4-2) that designate the method 
and sequence to be employed in combining terms or expressions. Blanks are not permitted 
within an expression. Evaluation of an expression begins with the substitution of values 
for each term. The operations are then performed from left to right in hierarchical order as 
listed in Table 4-2. The operation with the highest hierarchy number is performed first; 
operations with the same hierarchy number are performed from left to right. 


Parentheses can be used to alter the hierarchy of evaluation. Multiplication by O equals O. 
The 12 operators are divided into three classes: arithmetic operators, logical operators, and 
relational operators. More detailed descriptions of these operators are provided in 4.3.1, 
4.3.2, and 4.3.3. 


Table 4—2. Summary of Operators (Part 1 of 2) 


Arithmetic Operators A*/B is equivalent to Ar28 


Covered quotient, A//B is 
equivalent to (A+B—1)/8 


A/B means arithmetic quotient 
of A and B. 


A*B means arithmetic product 
of Aand B. 


A-—B means arithmetic difference 
of AandB. 


A+B means arithmetic sum of 
A and B. 


Logical Operators A**B means Logical Product 
AND of A and B. 


A++B means Logical Sum OR 
of AandB. 


A-——B means Logical Difference 
XOR of AandB. 
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Table 4—2. Summary of Operators (Part 2 of 2) 


Relation Operators has value 1 if true; 
has value 0 if false. 





A>B has value 1 if true; 
has value 0 if false. 


A<B has value 1 if true; 
has value 0 if false. 





4.3.1. Arithmetic Operators 


The symbols +, —, *, /, //, */ represent the six arithmetic operators. The intrinsic 
meanings of +, —, *, and / are the usual ones; that is, + indicates addition, — indicates 
subtraction, *indicates multiplication, and / indicates division. 


The operator // denotes a covered quotient where A//B is equivalent to (A+B-1)/B. A 


covered quotient is equal to regular binary division except that if there is a remainder, a 1 
is added to the regular quotient. 


The operator */ denotes a binary shift left or right. A*/B indicates a left shift and is 
equivalent to A*2®. A*/(—B) indicates a right shift and is equivalent to A/28. 


4.3.2. Logical Operators 


The symbols **, ++, and —— are the three logical operators. The characters ** represent 
the logical product (AND), and characters ++ represent the logical sum (OR), and the 
characters —— represent the symmetric difference (exclusive OR). 


Each bit of the first term is compared with its corresponding bit in the second term and 
the result of the comparison is placed in the corresponding position in the resulting term. 
(See Section 12.) The result of the bit comparison for each operator is: 
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4.3.3. Relational Operators 


The three relational operators are the equals operator =, the greater than operator >, and 
the less than operator <. 


The equals operator is used to compare the value of two terms or expressions. If the two 
values are equal, the assembler assigns a value of 1 to the expression; otherwise, a value 
of O is assigned. 


The greater than operator makes a comparison between two terms or expressions. If the 
value of the first (left) term is greater than the value of the second (right) term, than a 
value of 1 is assigned to the expression; otherwise, a value of O is assigned. 


The less than operator compares the value of the first (left) expression or term with the 
second (right) expression. If the value of the first expression is less than the value of the 
second one, then a value of 1 is assigned to the expression; otherwise, a value of O is 
assigned. 


For the expression A+B>C, if the expression A+B has a value greater than a value of C, 
then the assembler assigns a value of 1 to the expression; otherwise, a value of O is 
assigned. 


A relational expression consists of a relational operator and its two operands. The 
operands in a relational expression may be either two character expressions (4.4.5) or two 
arithmetic expressions. A character expression may not be compared to an arithmetic 
expression. Character expressions are valid only on conditional assembly directives. 


Since the evaluation of a relational expression yields an arithmetic result, a relational 
expression may be used as a term in an arithmetic expression. 


4.4. EXPRESSIONS 


An expression consists of one or more terms connected by operators. A leading minus 
sign is allowed to produce the negative of the first term. Each term in the expression may 
be either a relocatable term or an absolute term. A term is absolute if its value is not 
changed by program relocation. A term is a relocatable term if its value is changed by 
program relocation. Two relocatable terms may be considered to be paired if they have 
opposite signs and have the same relocatability attribute (that is, appear in the same 
control section). 


Evaluation of expressions obeys the following rules: 


7 Multiplication and division of a relocatable term by an absolute 1 or multiplication of 
an absolute 1 by a relocatable term produces a relocatable term. 


os Multiplication of any term by absolute O yields absolute O as a result. 


. If a relocatable term enters any multiply or divide operation other than the above, an 
error flag is given. 
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= The number of unpaired relocatable terms at any point in the evaluation must not 
exceed 16. 


= = Intermediate results of the expression evaluation are full 32-bit values; however, the 
final result is the truncated rightmost 24 bits. 


Three types of expressions, absolute, relocatable, and complex relocatable obtain various 
characteristics from the term or terms which compose them. These three types of 
expressions are discussed in 4.4.1 through 4.4.6. 


4.4.1. Absolute Expressions 


An absolute expression is an expression whose value is unchanged by program relocation. 
The absolute expression can be an absolute term or any combination of absolute terms. 
Arithmetic operators are permitted between absolute terms. 


Examples of absolute terms are: a symbol which has an absolute value, a self-defining 
term or a length attribute reference. 


Relocatable terms alone or relocatable terms in combination with absolute terms can be 
contained within an absolute expression. This type of absolute expression requires that 
each relocatable term be paired with another relocatable term which has the opposite sign 
and the same relocatability attribute. The paired terms need not be contiguous. 


The effect of relocation is canceled by the pairing of relocatable terms with the same 
relocatable attribute and opposite signs. The absolute expression is thereby reduced to a 
single absolute value. 


The following are examples of absolute expressions: 


A 

AtA—A 
A—A+A+A 
R+A—R 
R—R+A 
(R—R)*A 
A*A 


where: 


A 


Is an absolute term. 


Is a relocatable term. 
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4.4.2. Relocatable Expressions 


A relocatable expression is an expression whose value changes with program relocation. 
All relocatable expressions must be positive values. 


Relocatable terms alone or relocatable terms in combination with absolute terms can be 
contained within a relocatable expression. 


Either type of relocatable expression requires the following conditions: 
= All but one relocatable term must be paired. 
= A minus sign must not precede the unpaired (remaining) relocatable term. 


7 Each pair of relocatable terms must have opposite signs and the same relocatability 
attribute. 


= The paired relocatable terms do not have to be contiguous. 


Using the above requirements, a relocatable expression is thereby reduced to a single 
relocatable term. The following are examples of relocatable expressions: 


R 

R/1 

R+A or A+R 
R—R+R 
R—A 

R*1 or 1*R 


where: 


A 
Is an absolute term. 


Is a relocatable term. 


4.4.3. Complex Relocatable Expressions 


A complex relocatable expression is an expression that contains 2 to 16 unpaired 
relocatable terms or a negative relocatable term in addition to any absolute or paired 
relocatable terms. 


A complex relocatable expression may be written only in the operand field of either an A- 
type or Y-type address constant. (See 5.2.8 and 5.2.9.) 


Some examples of complex relocatable expressions are: 
A—R 


—R/1 
A—R—R+R-—R 
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where: 





A 
Is an absolute term. 


Is a relocatable term. 


4.4.4. Character Expressions 


A character expression is either a character string, a character substring, or a 
concatenation of strings or substrings. Character expressions are used as the operand of a 
SET or SETC statement or as terms in a SETB, SET, AIF, or DO relational expression. Any 
character string is considered to be greater in value than any shorter character string. A 
character expression may have a length of up to 127 characters. 


4.4.5. Length Attribute of Expressions 


The length attribute of an expression is determined by the assembler and it is a function of 
the leading term of the expression. If the first term of an expression is an absolute value, a 
length attribute of one byte is assigned to the expression. If the leading term is a symbol, 
the number of bytes attributed to the expression is the same as the length attributed to 
the symbol. Thus, if TAG appears in the label field of an LH (load half word) instruction, it 
would have a length attribute of 4 since LH is a 4-byte instruction. In referencing the 
same label, the expression TAG+195 also has a length attribute of 4, but the expression 
195+TAG has a length attribute of 1 because the leading term is a decimal self-defining 
term. 





4.4.6. Character Strings 


A character string is at least one of the 256 valid characters enclosed by apostrophes. A 
character string, unlike a character self-defining term, is not converted and treated as a 
binary value. The value of a character string is determined by its length. Any character 
string is greater in value than any shorter character string. Rules for writing character 
strings are: 


= Two apostrophes must be written within a character string to represent one 
apostrophe. The two apostrophes are replaced by a single apostrophe. 


a Two ampersands must be written within a character string to represent one 
ampersand. A single ampersand within the character string is interpreted as the first 
character of a variable symbol. 


A character substring is a valid character string followed by two arithmetic expressions 
separated by a comma and enclosed in parentheses. The format is: 





character string (e,,e,) 
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where: 
e; 
Specifies the leftmost character of the original string to be included in the 
substring. 
€2 


Specifies the number of characters to be in the substring. 

The expressions e, and e, must be valid SET expressions. (See 27.1.4.) If there are fewer 
characters (than the number specified by e,) remaining after character number e, in the 
string, the resultant substring is shortened to include only valid characters of the original 
string. A null character string results if e, is greater than the number of characters in the 
original string. 
Example: 
‘PREDEFINED’ (4,6) 
will produce the character substring 

‘DEFINE’ 
Concatenation is the joining together of: 
= two character strings; 
™ =§=two character substrings; or 
= acharacter string and a character substring. 
A period designates concatenation into a string of characters. 
Example: 

‘PRE’.‘DEFINE’ produces 

‘PREDEFINE’ 


When a substring is to be concatenated with a following character string, the period may 
be omitted and concatenation is assumed. 




















PART 2. STORAGE AND SYMBOL 
DEFINITIONS 
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5. Storage Definitions 


In almost all programs, inclusion of constant value is required for mathematical 
computation, headings for reports, and values or codes for comparisons. You also reserve 
storage for work areas, record keeping, and save areas. Two methods used to produce 
constants or reserve storage are: 


a define constant — DC 


s define storage — DS 


5.1. STORAGE USAGE 


There are 13 definition types used to describe the type and format of storage used. Table 
5—1 lists the characteristics of each of these storage notations. All the definition types 
shown are valid for both DC and DS statements. Except for floating-point constants (2.9, 
5.2.12, and Section 11), the formats of both statement operands are similar, as follows: 






LABEL A OPERATION A OPERAND 





[symbol] [d] tL, i wr 
[symbol] [d] t{L, ] [ia 
where: 
[symbol] 
Is up to eight characters. 
d 
Is the duplication factor in decimal. 
t 


Is the definition type. (See Table 5—1.) 
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L. 

is the explicit length factor in decimal. 
‘c’ 

Is the constant specification for data. 
(c) 


Is the constant specification for an address. 


Table 5—1. Characteristics of Constant and Storage Definition Types 


Constant or 
Storage Type 


Character 


Hexadecimal 


Binary 


Packed decima 


Zoned decimal 


Half word, 


fixed point 


Full word, 
fixed point 


Half-word 
address 


Full-word 
address 


Base and 
displacement 


External 
address 


Full word, 


floating point 


Double word, 
floating point 


Alignment 


None 


None 


None 


Half word 


Full word 


Half word 


Full word 


Half word 


Full word 


Full word 


Source Code 
Specification 


Characters 
Hexadecimal 
digits 


Binary 
digits 


Decimal 
digits 


Decimal 
digits 


Decimal 
digits 


Decimal 
digits 


Expression 


Expression 


One or two 


expressions 


Relocatable 
symbol 


Decimal 


digits 


Decimal 
digits 


Truncation Length in Bytes 


' Maximum 
or Padding | implied eeiee| Explicit * 


Variable 256 (DC) 
65,535 (DS) 


Storage 
Format 


Character 


Hexadecimal Variable 256 (DC) 


65,535 (DS) 


Binary Variable 


Packed 
decimal 


Variable 


Character Variable 


Fixed-point 
binary 


Fixed-point 
binary 


Binary 
Binary 

Base and 
displacement 
Binary 
Floating- 
point binary 
normalized 
Floating- 


point binary 
Normalized 





*The maximum explicit length in bytes is that total length produced by the explicit length factor times the duplication factor. 
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@ Following are DC-statement and DS-statement examples showing the use of the subfields, 
which must appear in the order stated and must not be separated by blanks. 
LABEL AOPERATIONA OPERAND 
1 10 16 
WRD32 DC 3CL9'CONSTANTS' 
EQUITY DS 3CL9 


| } 
duplication factor 

definition symbol 

length factor 


constant specification 
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DC 


5.1.1. Define Constant (DC) 


The define constant (DC) statement is processed by the assembler and the constant 
specification is translated into object code representing the required values. The maximum 
explicit length for a DC is 256 bytes. (See Table 5—1 for C, X, and B types.) 


The following five examples show the use of the subfields in a DC statement. 





LABEL AOPERATIONA OPERAND 
1 10 16 

1.1 N45 43 DC C'4543! 

2. | NAD DC 20'4543! 

3. | NAHS DC CL2' 4543! 

4. | WRD DC 2CL2' 4543! 

5.{ L591 DC SCL1'4543! 


1. Four bytes containing: Fla] F is|rtalets 





N4543 has a length attribute of four bytes, the number of bytes assigned the value 


‘4543’. 
2. Eight bytes containing: | F eres Pace 


NAD also has a length attribute of four bytes, as called for by the value ‘4543’, even 
though the duplication factor calls for two such fields of four bytes each. 


2 


3. Two bytes containing: | Fi4] Fi 5 
NAHS has a length attribute of two bytes, as specified by the length modifier, and 


only two bytes of storage are used. The digits 4, 3 are ignored. 


4. Four bytes containing: | F FIS 


WRD also has a length attribute of two bytes, as specified by the length modifier, but 
two fields of two bytes each are used because of the duplication factor of 2. The digits 
4, 3 are ignored. 


S 


1 1 
5. Five bytes containing: | Fi 4| F 14] F a 4) Fta 
L591 has a 1-byte length attribute, as specified by the length modifier of 1. There are 
five 1-byte fields, as called for by the duplication factor. The digits 5, 4, 3 are ignored. 
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DS 


5.1.2. Define Storage (DS) 


The define storage (DS) statement is processed by the assembler and the constant 
specification is translated into reserved storage. The maximum explicit length for a DS is 
65,535 bytes. (See Table 5—1 for C and X types.) The following five examples show the 
use of the subfields in a DS statement. Only the number, not the content, of the bytes 
reserved by a DS statement is determined by the assembler. 





LABEL AOPERATIONA OPERAND 
1 10 16 

V. PILE DS C' 4543! 

2. | AYAHC DS CL4 

3. |DNOMYAR DS 2CL4 

4, | REBEW DS 5Cur 

5. }OREG DS 3C'ANO.A' 


1. ILE reserves a 4-byte field with a length attribute of 4. 
2. AYAHC produces the same result as line 1. 


3. DNOMYAR reserves eight bytes composed of two fields of four bytes each. The 
length attribute of DNOMYAR is 4. 


4. REBEW reserves five bytes of storage consisting of five fields of one byte each. 
The length attribute here is 1. 


5. OREG reserves 15 bytes of storage. The constant field defines a 5-byte field, and 
the duplication factor calls for three of these fields. The length attribute of OREG 
is 5. 


5.1.3. Duplication Factor 


The duplication factor designates the number of identical constants or areas to be 
generated. An unsigned decimal value is used to specify the duplication factor. If no 
duplication subfield is used, the assembler assumes a factor of 1. A duplication factor of 
zero generates neither a constant nor a storage area and, if no length factor is specified, 
the location counter will provide the proper boundary alignment and assign the location 
counter value to the symbol used. A duplication factor of zero is not permitted with literals. 
(See Table 5—2 for an example of the use of the zero duplication factor.) Note that, even 
though the duplication factor can change the size of the storage area used, the use of the 
duplication factor does not change the length attribute of the field. (See 5.1.5.) The 
maximum value of the duplication factor is 256. 
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Table 5—2. Zero Duplication Area Examples 


000D48 WKAREA1 CL41 
000D71 WKAREA2 CL16 
000D81 WBE OCL121 
0Q00D81 OUTPUT1 OCL121 
000D81 NEWAREA1 CL41 
OOODAA NEWAREA2 CL80 


OOODFA SGAW OCL121 
OOODFA INPUT1 OCL121 
OOODFA COUNTS OCL3 
OOODFA COUNTS CL1°5’ 
OOODFB COUNT12 CL2‘12' 
OOODFD CL118 





The first work area shown, WKAREA1, has the hexadecimal location OOOOD48 and is 41 
bytes long. The hexadecimal value of 41 is 29, which is added in hexadecimal to produce 
the next hexadecimal location, O0OD71. (See C.1.) The next areas WBE and OUTPUT1 
show how we can assign different symbols to the same area. They do not take up storage 
space and so would have the same address of NEWAREA1, which you can see is 16 bytes 
away from the start of the last address. The hexadecimal value of 16 is 10, making the 
address of NEWAREA1 O0O0D81. Now plus 80 bytes (hexadecimal 50) produces the 
address OOODFA. 


5.1.4. Definition Type 


The definition-type symbol is required for both DC and DS statements to determine the 
alignment (5.1.7), padding, truncation, storage form, and implied length. (See 5.2 and 
Table 5—1 for the characteristics of the 13 types used.) 


5.1.5. Length Factor (L,) 


The length factor designates the explicit value of the length attribute of a field generated 
by a DS or DC statement. The letter n represents either an unsigned decimal self-defining 
term or a positive absolute expression enclosed within parentheses. If any symbols are 
used in the expression, they must be previously defined. The length attribute of a field 
used in an assembler instruction determines the number of bytes generated for either that 


constant or reserved field. The maximum value of the length factor (n) is 65,536. Examples 
follow: 
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LABEL AOPERATIONA OPERAND 
| 10 16 
1}. | WNS DC C'LENGTH ATTRIBUTE' 
2. | YAR DS CLI6 
3. | WOR DS 2CL16 
4. | SGAW DC CLI6'LENGTH' 
5. | STOR DC CLI6 


Examples 1 through 5 all have a length attribute of 16 bytes. The length factor is not 
required in example 1 because the constant specified is 16 bytes long. The length attribute 
of the receiving field in examples 2 through 5 is a vital element of the instruction. (See 
12.12.) 


When used, the length factor must follow the character L. The maximum and minimum 
values that may be explicitly specified are shown in Table 5—1 for all definition types. 
Constants that do not agree with the specified length are padded or truncated to the left or 
right, as shown in Table 5—1. 

NOTE: 


Boundary alignment is not provided when a length factor is specified. 


5.1.6. Constant Specification 


The constant specification determines the constant, or storage to be generated. When an 
apostrophe or ampersand is included in the constant specification, double apostrophes or 
ampersands are used to indicate the inclusion of these characters in the constant. 


Examples: 
1. 7YAR DC C'ENTER NUMBER ''4N'! HERE! 
2.116591 DC C'ENTER THE NUMBER 516691! 


This will produce 22 bytes as follows: 

1. ENTER NUMBER ‘4N’ HERE 

2. ENTER THE NUMBER 51891 

The constant may take the form of data or an address, as shown in Table 5—1. 
Data Constant Address Constant 


‘JUNE 15° (AREA1) 
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5.1.7. Alignment 


Machine instructions are aligned on half-word boundaries; constants may be aligned on a 
half word, full word, double word, or no boundary. (See Table 5—1). When a length factor 
is specified in the DC or DS statement, no alignment is provided. A duplication factor of 
zero does not generate a constant or storage area but, for some types of constants, it 
forces a boundary alignment when no length is stated. This provides a method for 
obtaining boundary alignment before generating a constant that is not automatically 
aligned by the assembler. Bytes skipped to align constants are zero filled; bytes skipped to 
align storage areas are not. 


5.2. DEFINITION TYPES 


Data definition types generate absolute values or storage through the assembler 
interaction. There are 13 types, as shown in Table 5—1 and described in more detail in 
5.2.1 through 5.2.12. (Also see 2.1.) 


5.2.1. Character Constants (C) 


The character C is used to specify character constants and can produce up to 256 bytes 
for a DC and 65,535 bytes for a DS statemnent. All of the 256 valid card punch 
combinations can be used, but only 48 or 64 characters are printable, depending on the 
print set available. When the length factor does not agree with the constant specification, 
padding or truncating takes place on the right. Padding takes place with blanks. (See 2.1 
and 2.4.) 





LABEL AOPERATIONA OPERAND 
1 10 16 

1. | PADDING DC CLIG' CONSTANT! 

2.] TRUNCAT DC CLS'CONSTANT' 

3.1 NORMAL OC C'CONSTANT! 


1. Produces: CONSTANTAA _ (ten bytes) 
2. Produces: CONST (five bytes) 
3. Produces: CONSTANT (eight bytes) 


A pair of ampersands is needed to specify a single ampersand constant. A pair of 
apostrophes is needed to specify a single apostrophe constant. 
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5.2.2. Hexadecimal Constants (X) 


The character X is used to specify hexadecimal constants and can produce up to 256 bytes 
for a DC and 65,535 bytes for a DS statement. Each byte contains two hexadecimal digits. 
When the length factor does not agree with the constant specification, padding or 


truncating takes place on the left. Padding takes place with hexadecimal zeros. (See 2.1 
and 2.3.) 





LABEL AOPERATIONA OPERAND 
] 10 16 

1.} PADDING DC XL7'C4CED5F3FA! 

2.| TRUNCAT DC XL4'C4CEDSF3FA' 

3.| NORMAL DC X'CHCEDSF3FA' 


7 bytes 


f] 
2. Produces: CIE fois|Fis|F yal 4 bytes 
ia{cte]ots|r ya] 
3. Produces: OLS ere t 


t 
tA 5 bytes 


nn 


5.2.3. Binary Constants (B) 


The character B is used to specify binary constants and can produce up to 256 bytes. 
When the length factor does not agree with the constant specification, padding or 
truncating takes place on the left. Padding is done with binary zeros. The constant 
specification consists of only the numerals O and 1. (See 2.1 and 2.2.) 





1.) PADDING OC BL2'9116' 

2.) TRUNCAT DC BL1' 188611188116! 

3.) NORMAL DC B'111901196' 
1. Produces: 0000 | 0110 2 bytes 
2. Produces: 1110 | 0110 1 byte 


i] 
1110 4 0110 1 byte 
3. Produces: 1 
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5.2.4. Packed Decimal Constants (P) 


The character P is used to specify signed packed decimal constants. It can produce up to 
16 bytes. When the length factor does not agree with the constant specification, padding 
or truncating takes place on the left. Padding is done with hexadecimal zeros. The decimal 
constant is written as a signed or unsigned number. If unsigned, the number is assumed 
to be plus. A positive number is assembled with a hexadecimal C in the four least 
significant bits; a negative number has a D in this location. The maximum of 16 bytes can 
contain 31 decimal digits plus the sign. (See 2.1 and 2.4.3.) 





LABEL AOPERAT! wwe OPERAND 
1 10 16 

1.) PLUS DC P'+454 3! 

2.1NEG pc P'—4543! 

3.] UNSIGNED DC P'hoh3! 

4, | PADDING DC PLA'+4543! 

5.}TRUNCAT DC PL2'=4543! 

6.}ODDNUN 0C 


1. Produces: 


3 bytes 
3. Produces: fora{sia | 3 fic | =o 
r 1 4 bytes 

4. Produces: [9 10] 34/5 {4 [3 }¢) 
i 2 bytes 

6. Produces: 
! 3 bytes 


6. Produces: 


5.2.5. Zoned Decimal Constants (Z) 


The character Z is used to specify zoned decimal constants. It can produce up to 16 bytes. 
When the length factor does not agree with the constant specification, padding or 
truncating takes place on the left. Padding is done with zoned zeros (FO). A plus or 
unsigned number is assembled with a C in the zone half of the rightmost byte; a negative 
number will have a D in this location. (See 2.1.) 








1.} PLUS DC Z'+h543! 
2.| NEG DC Z'-4543! 
3.] UNSIGNED DC Z'4543' 
4.| PADDING DC ZL5' +4543! 
5.|TRUNCAT DC ZL3'-4543! 
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re i) I ] 
t i] 
2. Produces: Poaache ws D1 3 4 bytes 
I i 
' t 1 1 
3. Produces: Fi4j)F 15) F,41Ci13 4 bytes 
i 
pole Lal Fat ole ales 5 bytes 
4. Produces: i4qe} 
] i] i 
Feb] Fi4 D: 3 3 bytes 
5. Produces: Pris 


NOTE: 


A zoned decimal number is also known as a signed unpacked number. (See 2.4.3.1 
and 2.4.3.2.) 


5.2.6. Half-Word Fixed-Point Constants (H) 


The character H is used to specify half-word fixed-point constants. It can produce up to 
eight bytes. If no length factor is specified, the length attribute equals the implied length of 
two bytes. Padding or truncating takes place on the left. Padding is done with the sign of 
the value, binary O for a positive number and binary 1 for a negative number. The constant 
specification may not contain over five significant decimal digits nor a value greater than 
+32767 (2'5-1) or less than -32768 (-2'5). Unsigned values are treated as positive values. 
The data is aligned on a half-word boundary. (See 2.1, 2.5, and Section 10.) 





LABEL AOPERATIONA OPERAND 
] 10 16 
1. ] PLUS] DC HL1'+57! 
2. | PLUS2 DC H'57' 
3.1 NEG] DC HLI'=57! 
4. | NEG2 DC H'=57! 
(+) sign bits 
1. Produces: 1 byte 
I 


i ! 
2. Produces: ooco +: 0000 0011 1 1001 2 bytes 


(—) sign a 
i 
3. Produces: 1100 3 0111 1 byte 


4 
4. Produces: 1111, 1 1111 1100 1 0111 2 bytes 


“th 





UP-8061 Rev. 3 SPERRY UNIVAC OS/3 5-12 
ASSEMBLER 





5.2.7. Full-Word Fixed-Point Constants (F) 


The character F is used to specify full-word fixed-point constants. It can produce up to 
eight bytes. If no length factor is specified, the length attribute equals the implied length of 
four bytes. Padding or truncating takes place on the left. Padding is done with the sign of 
the value, binary O for a positive number and binary 1 for a negative number. The constant 
specification may not contain over 10 significant decimal digits nor a value greater than 
+2,147,483,647 (23'-1) or less than -2,147,483,648 (-23'). Unsigned values are treated as 
positive values. The data is aligned on a full-word boundary. (See 2.1, 2.5, and Section 
10.) 





LABEL AOPERATIONA OPERAND 
] 10 16 

1.] PLUS2 DC FL2'+271! 

2.] PLUS4 DC F271" 

3.4) NEG2 DC FL2'-271' 

4} NEG4 DC F'-271' 


Sign bits — 
' ' 
0000 : 0001 0000 i 1111 2 bytes 


0000 | 0000 | 0000 1 0000 | 0000 | 0001 | 0000 ; 1111 
t ( 1 
Sign bits 


T 
3. Produces: 1117-1 1110 | 1111 | 0001 | 2 bytes 
eel eee 
: 1 
P ; ; ! 


5.2.8. Half-Word Address Constants (Y) 


1. Produces: 






2. Produces: 4 bytes 





The character Y is used to specify half-word address constants. It can produce up to two 
bytes. If no length factor is specified, the length attribute equals the implied length of two 
bytes. Padding or truncating takes place on the left. Padding is done with binary zeros. A 
length factor of one byte may be specified for absolute expressions only. The expression 
may be a positive or negative absolute value or a ‘elocatable symbol representing the 
address of an instruction or item of data within the program. Alignment is on a half-word 
boundary. The maximum value that can be specified is 215-1 (32,767). 


1. | WRD Dc Y (EQUITY) 
2. | WBE DC YL1(9) 
3. |wMc DC Y (9) 
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@ 1. Produces a 2-byte area containing the address of the instruction EQUITY. 


2. Produces: 0000 1001 1 byte 
‘ 7 
3. Produces: 0000 1 0000 | 0000 } 1001 2 bytes 


5.2.9. Full-Word Address Constants (A) 


The character A is used to specify full-word address constants. It can produce up to four 
bytes. If no length factor is specified, the length attribute equals the implied length of four 
bytes. Padding or truncating takes place on the left. Padding is done with binary zeros. 
Length factors of one or two bytes may be specified for positive or negative absolute 
values. The maximum value that can be specified is 23'-1 (2,147,483,647). Alignment is 
on a full-word boundary. 





LABEL AOPERATIONA OPERAND 
1 10 16 
1. | WRD DC A(VALLEY) 
2. | WBE pc AL1(9) 
3. | WMC DC AL2(9) 
Se 1. Produces a 4-byte area containing the address of the instruction VALLEY. 


t 
2. Produces: 0000 1; 1001 1 byte 
1 
3. Produces: 0000 1 0000 0000 t 1001 2 bytes 


5.2.10. Base and Displacement Constants (S) 


The character S is used to specify base and displacement constants. It can produce a 2- 
byte area. The only length factor that may be specified is 2. No padding or truncating can 
take place. Alignment is on a half-word boundary when the length factor is not used. 
Neither negative values nor literals may be used. This instruction produces a 2-byte area, 
as follows. 


1 BYTE 1 BYTE 


BASE ee 
REGISTER es 
(4 BITS) 


The first four bits (half byte) contain the number of the base register used in this constant. 
& The next 12 bits contain the value of the displacement to be added to the value in the 
register to produce the full address of the constant. 





eee 
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In the following example, in line 1, the value 5000 will be placed into register number 9 at 
execution time. (See 18.2 for the USING directive.) In line 2, assume the program has 
produced the address of 5025 to be assigned to the instruction called ELI, and this 
instruction is 25 bytes away from the area covered by register number 9. The instruction 
CHAYA, line 3, specifies the address of ELI, which is register number 9 (value 5000) plus 
a displacement of 25 bytes to give 5025. The instruction REBEW does not use an address 
symbol but explicitly states the displacement, 25 bytes, and register number 9. 


Examples: 


LABEL AOPERATIONA OPE RAND 
1 10 16 





USING 5600 ,9 


ELI DC C'CONSTANT' 
CHAYA DC S(ELI) 
REBEW DC §(25(9)) 


The constants produced in lines 3 and 4 show the hexadecimal values of the base register 
and the displacement as follows: 





BASE DISPLACEMENT 
REGISTER 


5.2.11. External Address Constants (V) 


The character V is used to declare references to special external symbols. The constant 
must be used to reference an executable instruction which is external to the program. The 
reference symbol need not be identified by an EXTRN statement. (See 19.5.) 


The only length factors that may be specified are 3 or 4. If no length factor is used, the 
length attribute equals the implied length of four bytes and alignment will be on a full- 
word boundary. 
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Padding or truncating takes place on the left. Padding is done with hexadecimal zeros. 


The specification of a symbol in the operand field of a type V constant does not constitute 
a definition of the symbol. 


Until the program containing the external symbol is linked to the program with the V type 
constant, the value of the assembled constant is composed of hexadecimal zeros. 


Example: 
LABEL AOPERATIONA OPERAND 
} 10 16 
LODGE DC V (TRAVEL) 


As the address value of this DC instruction (TRAVEL) is externally defined, the following 


constant is generated. 


5.2.12. Floating-Point Constants (E and D) 


The format of floating-point constants differs from the standard format of the DC 
statement (5.1) in that an additional subfield (the scale modifier) may appear. The format 
for floating-point constants is as follows: 





OPERAND 


[d] t(L, [Stn] ‘c[E+n]’ 


A OPERATION A 






[symbol] 





where: 


Is the duplication factor. 


Is the definition type (E, full word; D, double word). 


Is the explicit length factor in decimal. 


S-+n 
Is the scale modifier. 


‘c[E+n]’ 
Is the constant specification with optional exponent. 
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The subfields must be written in the order given. The d, t, and Ln subfields are discussed 
in 5.1. The scale modifier must be a positive signed or unsigned decimal number. If the 
sign is omitted, a positive value is assumed. The scale modifier is applied to a number 
after it has been converted to internal format. 





Two types of floating-point constants are available: full word (E) and double-word (D). The 
implied length of an E type constant is four bytes; if the length modifier is omitted, full- e 
word boundary alignment is assigned. The implied length of a D type constant is eight 

bytes; if the length modifier is omitted, double-word boundary alignment is assigned. In 

either case, an explicit length modifier of from one to eight bytes may be specified. 


A floating-point number is written as a decimal number. It can be an integer (110), a 
fraction (0.75), or a mixed number (110.75). The floating-point number may be followed by 
an optional exponent represented by an E, a sign, and a decimal number, respectively. In 
the absence of a sign, a plus sign is assumed. 


The exponent for a constant is that power of 10 by which that constant will be multiplied 
before its conversion to internal format. This exponent value may range from —85 to + 
75. 


The machine representation of the constant consists of a hexadecimal fraction (mantissa) 
and a hexadecimal exponent (characteristic). The decimal point is assumed to be at the left 
of the leftmost digit of the fraction. The characteristic represents the power of 16 by which 
the fraction must be multiplied to obtain the value of the constant. The machine format is 


shown in Figure 5—1. & 





(SHORT FORMAT) 


characteristic mantissa 
(exponent) (fraction) 
6 hexadecimal! digits 


(LONG FORMAT) 


DOUBLE G characteristic ee 
WORD (exponent) (fraction) 


14 hexadecimal digits 
where: 


SIGN 
is the O bit, the sign of the mantissa. 


CHARACTERISTIC 
Is a 7-bit binary number (signed and biased by the hexadecimal value 40,¢, decimal value 64) reflecting the scaling of 
the floating-point number. 


MANTISSA 
Is the fraction after the constant has been converted to its machine representation; scaling is performed if specified. 





Figure 5—1. Floating-Point Number Formats 
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@ Example: 


The floating-point value is the product of the mantissa (fraction) and the base 16 
raised to the power of the biased characteristic (exponent) after the exponent has 
been reduced by 64. The decimal number 255 will generate the floating-point number 
42FFOOOO. 







A OPERATION A OPERAND 


[symbol] 


Decimal 255 = the fraction X16. The floating-point number shown in hexadecimal form is 
42F FOOOO. 


In this example: 


n = hexadecimal 42 (decimal value 66) fraction = .FFOOOO (decimal value .9961 from 
the table in C.2). Therefore, 42FFOOOO equals: 


.9961 X 1666-64 
or .9961 X 16? 
or .9961 X 256 


@ or 255 


If scaling is not specified, the fraction is hexadecimally normalized; that is, all leading 
hexadecimal zeros are removed, and the characteristic is adjusted by 1 for each zero 
removed. Rounding is then performed, and the number is assembled into the field as 
specified by the explicit or implicit length. Negative fractions are carried, not in two’s 
complement, but in true representation. 


The scale modifier must be a positive value from O to 14. This modifier specifies the 
number of hexadecimal positions (four bits) the number is shifted to the right. Scaling 
provides an unnormalized floating-point number. The characteristic is adjusted to 
reflect the number of hexadecimal positions the number has been shifted. If any 
hexadecimal positions are lost, rounding occurs in the rightmost hexadecimal position 
retained. 


Examples: 
Normalized number, i 
value 256. Pet2{rielotoloto. 
Unnormalized number, 1 fofr[Froloro| 
413 
value 255. 
Unnormalized number, fataloto ee Foto | 
& value 255. ! 


See 2.6, Section 11, and Appendix C. 
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5.3. LITERALS 

A literal is a representation of data within a source code statement and can be coded in 
the sending field of either operand. A literal is simply a constant coded with an equal sign 
followed by a type code and a nominal value enclosed within single quotation marks. 
The method of describing and specifying a constant as a literal is almost identical to the 
method of specifying it in the operand field of a DC statement. When a literal is 
assembled, the data is stored in a “‘literal pool’’ which is a special area in main storage 
where all literals are placed. The address of that storage field in the literal pool is then 
placed in the operand field of the assembled statement. 

If two identical literals occur within one literal pool, only the first literal is stored. 

The permissible uses of literals are: 

= Any type of data can be used to specify a literal. 

= Only one reference to the same literal in a coding statement can be made. 


= @6A literal is always in the sending field of an operand. 


a Literals are relocatable because the address (not the literal itself) is assembled in the 
coding statement. 


= = Literals can be self-defining terms which are recognized by the absence of the equal 
sign, also referred to as immediates. 


= Duplication factors can be used in the specification of literals and are expressed only 
by unsigned decimal values except zero. 


. Length attributes can be used in the specification of literals and are expressed only by 
unsigned decimal values. 


The nonpermissible uses of literals are: 

= A literal can never be used in the receiving field of an operand. 

= A literal cannot be combined with other terms. 

= ~§=|It cannot be specified within the parenthesis of an address constant. 

| It cannot be specified in a shift instruction, or an 1/O instruction (SIO). 
= ~@§6A literal cannot have an explicit base or an explicit index. 


= Absolute (with all terms previously defined), relocatable, or complex relocatable 
expressions cannot be used as either duplication factors or length attributes. 
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Example: 


LOC. 
000000 
000000 
000002 
000002 
000006 
O00000A 


QOOO0E 


OOO00E 
0000t0 
000014 
000018 
OO00IC 
000000 
000020 


OBJECT CODE ADDR] 
0530 
58B0 3016 


5ABO 301E 
42B0 301A 


1700 
OAIB 


000008BC 
FOLO4040 


00000005 


SPERRY UNIVAC OS/3 


5—19 


ASSEMBLER 
ADDR2 LINE SOURCE STATEMENT 
1 sTe START 0 
2 BEGIN BALR 3,0 
3 USING *,3 
00018 4 L 11,AMTIN 
00020 5 A 11,=F'5! 
ooolc 6 STC 11,STOR 
7 DUMP 
A 8+ DS OH 
A O+* 
A 10+ THE DUMP PARAMETER IS A 1-4 BYTE HEX CODE 
A 1\+ 
A 12+ XR 0,0 CLEAR DUMP CODE 
A 13% svc 27 DUMP SVC 
14 DS F 
15 AMTIN DC F'2236! 
16 STOR DC CL4'O! 
17 END BEGIN 
18 =F'O! 


On line 5 of the sample program, a literal is used in the sending field of operand 2. The 
equal sign is used followed by the type code (which in this case is F, full word) and the 
nominal value enclosed in single quotation marks. Note that the object code produced 
when the literal is assembled is the address (00020) of the field in the literal pool where 
that literal was placed. Line 18, under object code, shows the literal actually generated. 
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6. Symbol Definitions 


Byte locations in main storage are numbered consecutively starting with zero. Each 
number is considered the address of the byte of data stored at that location. A group of 
consecutive bytes is addressed by the leftmost byte. A symbol appearing in the label field 
of a statement defining an instruction, constant, or storage area is assigned the address 
value of the first byte of the source statement with which the symbol is associated. The 
following rules apply to the genera! use of symbols. 
= Must start in column 1 
= Must start with an alphabetic character or special letter 

@ = Must consist of only alphabetic characters, numeric characters, and special letters 
= Must not be longer than eight characters 
7 Must not include a space (blank) or other special character 


= =6©Must be followed by a blank 


Example of valid label field symbols: 





LABEL AOPERATIONA OPERAND 
] 10 16 

W pc P'4g69! 

N4543 DS PL4 

DNOMYARD DC C'5p6¢! 


CASHSOUT BALR R5,@ 
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Examples of invalid symbols: 
LABEL AOPERATIONA OPERAND 
| 10 16 

1.1 EQUITY DC P'hg2! 

2.) 4543 DS ZL4 

3.| READ ONE PACK OPER! ,OPER2 

4. | CONSISTORY DC C'8¢! 
1. Invalid because symbol does not start in column 1 


2. Invalid because symbol does not start with an alphabetic character or special 
letter 


3. Invalid because symbol contains a special character (space) 


4. Invalid because symbol is longer than eight characters 


6.1. EQUIVALENT SYMBOLS 


To make a program more meaningful, the programmer may use more than one symbol to 
represent the same value or location. The same output area could be called NURECORD 
(in one place) and OUTPUT1 in another part of the program. The EQU directive (Section 
16) can be used, as shown in this section, to equate these symbols. An EQU may be used 
to equate any symbol to any other symbol or to a value. Only the operands may declare 
expressions. 





NURECORD EQU OUTPUTI 
RB EQU g 

Rl EQU | 

R2 EQU 2 

R3 EQU 3 

R12 EQU 12 

R13 EQU 13 

R14 EQU 14 

R15 EQU 15 
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@ After the EQU directive, a register instruction could be written in any of the following 
ways: 
LABEL AOPERATIONA OPERAND 
1 10 16 
ADD AR 1,2 
ADD AR R1,R2 
LOAD LA 5 ,2(5) 
LOAD LA R5,2(R5) 
MOVE MVC WKAREA , REC 
MOVE MVC 15(7,9) ,5(19) 
MOVE MVC 15(7,R9) ,5(R1B) 
NOTE: 


Throughout, the register notations (RO through R15) represent the registers O through 15. 


6.2. SYMBOL APPLICATIONS 


Symbols are used not only to identify storage areas and constants but also to locate 
instructions in the program. In the following example, the branch instruction with the 

@ symbol RETURN calls for a branch to the location CONSIS32 under certain conditions. The 
branch instruction called TRAVEL branches around the nonexecutable DC constants to the 
location SQUARE. 


TITLE "SYMBOL USE' 
START 
BEGIN BALR R3,RG 
USING * ,R3 
CONS1S32 MVC VALLEY ,CONSISTO 
TRAVEL 8B SQUARE 
WMC DC C'365' 
WRD32 DC C'32' 
SQUARE LR R2,R4 
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LABEL AOPERATIONA OPERAND 
] 10 16 
RETURN BC 7, CONSES32 
MASTER CLC WEEKS52 ,=P'52' 

EOJ 
RO EQU g 
R2 EQU 2 
R3 EQU 3 
R4 EQU 4 
REBEW DC P'+52! 
WEEKS52 EQU REBEW 
VALLEY ODS CL32 
CONSISTO DS XL32 

END BEGIN 


The EQU directives show how to use the symbol WEEKS52 for REBEW; also RO,R2,R3, 
and R4 for registers O, 2, 3, and 4. 


Through the extensive use of symbols and the assembly listing cross-reference, you can 
trace every use of a data area or instruction routine. (See 28.5.) 

















PART 3. BAL APPLICATION INSTRUCTIONS 




















UP-8061 Rev. 3 SPERRY UNIVAC OS/3 7-1 
ASSEMBLER 





7. Introduction to Application 
Instructions 


7.1. INSTRUCTION AND FORMAT CONVENTIONS 


Certain conventions have been adopted in this manual for specifying instruction, directive, 
macro, proc, and control-statement formats. The following paragraphs describe these 
conventions. 


There are six types of assembler application instructions: 


RR — Register-to-register 

RX — Register-to-storage-indexed or storage-to-register-indexed 

RS — Register-to-storage-nonindexed or storage-to-register-nonindexed 
SI — Storage immediate 

SS — Storage-to-storage (Type SS1) 

SS — Storage-to-storage (Type SS2) 


Figure 7—1 illustrates the source code and object code formats for each of these 
instruction types. (Also see Section 4.) 











Source Code Instruction Format 





| Type 
Explicit Form 


RR [symbol] opcode ie ® 


2 





Instruction ve 


Implicit Form 


Object Code Instruction Format 

































First Half Word 


Byte 2 
11{12 


Byte 1 


( 

{ reg reg 

| opt op 2 
Ve —_— i 













Second Half Word 
Bytes 3 and 4 


address | 




















Third Hatf Word 
Bytes 5 and 6 












































| 
| @ | ae ' operand 2 } 
1 ' 
RX [symbol} opeate d, (x,,b,} [symbo!] opcode 14 8Q(x,) 4 a2 t Bite ee 
opcode 5 b, d, 
| ' | 
1 reg reg ; address 
! 1 op 1 op 3 operand 2 
RS [symbol opcode Fr, .r.d, (b,) ® [symbol] opcode 1.15.5, } Te es ect aa 1 ee ee 
opcode 5 fS b, qd, 
3. 
| immediate ' address : 
operand operand 1 ! 
S| {symbol] opcode 4, (b,)i.® [symbol] opcode Sy4y 4 peng ans | pce | Se 1 
t < 4. 
' 
opcode i, i b, dq, ' 
— ST gn | 
' \ Jength 1 address ! address 
! 1 and op 2 } operand 1 ] operand 2 
{symbol] opcode 4, (I.b, )d,(b,) [symbol] opcode s,s, i ae is i I Lr ae : 
opcode 1-3 b. d b. | d. 
Ss , 1 2 2 
| ' length | address address 
t { 1 2 ! operand 1 operand 2 
[symbol] opcode d , (1, .b,).d,(I,,b,} [symbol opcode s,ll,)so,) i ‘ aan scene ! en 1 t 
L opcode i-1 | 1-1 | b, | dq, | b, | d, 
0 718 11 g12 15 }16 19 120 31 32 35 136 47 
NOTES 


@ The RR instruction has three other forms: 
[symbol] opcode i, for the SVC instruction; 
[symbol] opcode r, for the SPM instruction; and 


(symbol] opcode m,.r, for the 
BCR instruction. 


@ The RX instruction BC is 
written in the form: 


[symbol] opcode m,,d2{x,,b,) 








Figure 7—1. 


The RS shift instructions are written without use of the r; operand, in the form: 


[symbol] opcode r,,d(b.} 


Some SI instructions, such as TS, SSM, and SIO, do not use an i, field. They are written in the form: 


{symbol} opcode d,(b,} 


Instruction Formats (Part 1 of 2} 





YsTaWSasSsv 
€/SO DVAINN AYYAdS 


€ “AeY 1908-dN 
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Characters Meaning 
OPCODE The application instruction operation code. 
' The number of the general register containing operand 1 
ly The number of the general! register containing operand 2 
ry The number of the general register containing operand 3 
Xy The number of the general register containing an index number for operand 2 of the RX instruction 
i, The immediate data used as operand 1 of the SVC instruction 
ip The immediate data used as Operand 2 of an SI instruction 


| The length of the operands as stated in source code* 


I The length of operand 1 as stated in source code* 


ln The length of operand 2 as stated in source code* 

b, The number of the general register containing the base address for operand 1 
b, The number of the general register containing the base address for operand 2 
q, The displacement for the base address of operand 1 

d, The displacement for the base address of operand 2 

m, The mask used as operand 1 

op, Operand 1 

op, Operand 2 

op, Operand 3 

Sy The symbol used to identify operand 1 in the implicit format 

85 The symbol used to identify operand 2 in the implicit format 


*In source code, the length you specify is 1 greater than the object code length. The reason for this is that 0 is the first length 
count, not 1. For example, | can address a maximum length of 256, but in actuality, | get O through 255 bytes. The assembler 
makes a reduction of 1 in the length when converting source code to object code. 


Figure 7—1. Instruction Formats (Part 2 of 2) 


An instruction is an executable statement for operations involving data. The assembler 
instructions are two, four, or six bytes in length. (See Figure 7—1.) In a 2-byte (RR) 
instruction, the registers are referenced for both operands. A 4-byte (RS) instruction 
references a register for the first operand and main storage for the second operand. A 4- 
byte (RX) instruction references registers for the first and second operands and main 
storage for the third operand. A 4-byte immediate operand (Sl) instruction references main 
storage for the first operand and immediate data for the second operand. A 6-byte (SS) 
instruction references main storage for both operands. 


NOTE: 


All instructions are aligned by the assembler on a half-word boundary. 
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The implied length field may be applicable with the SS1 and SS2 type instructions. If no 
length is specified in an SS1 type instruction, the length attribute of the first operand is 
assembled into the length field of the instruction. The length attribute of an operand is the 
length attribute of the expression used to define the storage location. The SS2 type 
instruction contains a length field for each operand; however, neither, either, or both 
length fields may be implied. In every case, the assembler puts the operand lengths, 
implied or specified, into the length fields. 


The following are examples of implied and explicitly stated lengths. 





LABEL AOPERATIONA OPERAND 
1 10 16 
NUMBERI2 DC ZL12'+6! 
NUMBER7 DC Z'1234567' 
1. ] PAD PACK NUMBERI2,NUMBER7 
2.]/FILLUP PACK NUMBER] 2(4) ,NUMBER7 
3. | TRUNCATE PACK NUMBER12 (4) , NUMBER7 (3) 


Instruction 1 (PAD) packs all seven digits and the sign of operand 2 (NUMBER7) into four 
bytes of operand 1 (NUMBER12), then zero fills the remaining eight bytes of the implied 
field of 12 bytes. Instruction 2 (FILLUP) packs all seven digits and the sign of operand 2 
into the explicit four bytes of operand 1. Instruction 3 (TRUNCATE) packs cnty ihe explicitly 
stated three digits and the sign of operand 2 into the explicit four bytes of operand 1. 
Labeled instructions themselves are assigned implied lengths based on instruction type. 


There are six basic ways to explain how an assembler application instruction is written: 
the implicit format, the implicit source code example, the explicit format, the explicit 
source code example, the object code format, and the object code example. The first four 
methods are shown for each instruction in this part of the user guide as the subject of 
object code formats covered in 4.3.1 and are discussed again in assembly listings (Part 6). 
The fgllowing shows how the move character instruction is written. 


LT Implicit source code: 


Format: 






A OPERATION A OPERAND 


[symbol] 





Example: 


MOVES = MVC LODGE ,MASTER 
MOVE32 MVC LODGE (32) ,MASTER 
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7 Explicit source code: 


Format: 






AOPERATION A OPERAND 












[symbol] d, (Ib, ),d, (b,) 





Example: 

LABEL AOPERATIONA OPERAND 
1 10 16 

MOVE32 MVC 32(5,R2) ,3(R3) 


ws Object code: 


Format: 


opcode b, 
0 7 16 19 
no do 
32 35 | 36 47 


Example as shown on an assembly listing: 





OOODF5 D2 1F 20F1 30FC 


7.2. EXPLICIT FORMS 


The first line is how the explicit format is expressed, and the second line is an example of 
how you might write the explicit source code form of the add instruction. 


Explicit Format: 







A OPERATION A OPERAND 


[symbol] 
ADDREC 


r, d,(x,,b,) 
R2,32(R3,R5) 
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7.3. IMPLICIT FORMS 

The first line is how the implicit format is expressed, with the following one or more lines 
being examples of how you might write the implicit source code forms of the add 
instruction using symbols to represent registers and data areas. 


Implicit Format: 





A OPERATION A OPERAND 





[symbol] r, 085 (x,) 
ADDFOR R2, PAYSUM 
ADDREG R2, PAYSUM(R3) 


7.4. DEFINITIONS OF FORMAT TERMS 

Figure 7—1 explains all the terms used in describing the explicit and implicit forms of the 
instructions. The following additional explanations will help you to understand the implicit 
and explicit forms of programming coding. 


= The general registers r,, r2, or rz are shown in the RO through R15 form. 


m The index register x, and the base registers b, and b, are also shown in the RO 
through R15 form. 


= The terms s, and s, represent the use of a symbol (4.2.1 and Section 6) in the first or 
second operand. 


s The displacement d, or d, is a decimal value which is combined with the value in 
some base register. 


= Acheckoff table is included for each applicable instruction in the text. Explanations of 
the program exceptions are provided in Appendix D. 
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8. Branching Instructions 


8.1. USE OF BRANCHING INSTRUCTIONS 


Branching instructions are used to alter the normally sequential execution of instructions 
by branching out of sequence to link to a subroutine, make a decision, or control looping. 
The operand 2 field of each branching instruction refers to the address (branch to) of the 
instruction to be executed immediately after the branching instruction. The branch-to 
address in operand 2 is stored in bits 40—63 of the current program status word (PSW) 
(Figure 8—1). The PSW is a double word containing the address of the next instruction 
and various other control! fields. In general, the PSW is used to control instruction 
sequencing and to hold and indicate the status of the system in relation to the program 


currently being executed. (See the processor programmer reference, UP-8052 (current 
version) for a complete description of the PSW.) 


INTERRUPT 
KEY MODE Sane 
M 
p}p 
A O 
R|s N 
ls 11] 12] 131 14] 15 g1 19] 20 23 | 24 31 
ae See ee oe eee ee 
PROGRAM 


INSTRUCT DRE 
MASK NS CTION ADDRESS 








SYSTEM MASK 










= 
4ono- 
myapum 
mppumn 
myppwum 
mupwn 
mppum 
mppvun 


o 
= 
nN 
Ww 
bh 
oO 
o 


BYTE 









ILC cc BIDIE;S 
32 33134 35] 36) 37} 38] 39) 40 63 
a 


—y 





BYTE 








Condition 
id 

Gees Address of the next instruction 
to be processed (branch to) 


Figure 8—1. Program Status Word Diagram 
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While the program is executing, it utilizes the PSW (called the current PSW), which is 
stored in the supervisor portion of the operating system. Before a branch out of the 
sequence of the program to a new location, the present location of the program is stored 
in the PSW. That PSW (called the old PSW) is saved, and the program uses a new PSW 
(current) to keep track of pertinent program information. In other words, the old PSW holds 
the place in the program if you want to return to where you were before branching to a 
routine or instruction in another area, and the current PSW keeps track of the running 
program regardless of where you branched to. 


There are additional branching instructions, which are part of the featured instruction set 
(Section 14). You can use the featured instructions only if the processor has the control 
feature. 


For an explanation of the checkoff table exceptions, see Appendix D. 


8.2. EXTENDED MNEMONIC CODES 


Possible Program Exceptions 


(J ADDRESSING C] PROTECTION 






OBJECT 
















seetoen || FORMAL Aba (0 DATA (INVALID SIGN/DIGIT) | (] SIGNIFICANCE 
| mnem. [HEX,| ieee eS) (J DECIMAL DIVIDE C0 SPECIFICATION: 
CO DECIMAL OVERFLOW NOT A FLOATING-POINT REGISTER 
DC execute OP 1 NOT ON HALF-WORD BOUNDARY 


Axann| 20rd | 
Condition Codes 


Cir RESULT = 0,SET TOO 
Clif RESULT <o, SET TO1 
Clif RESULT >0, SET TO 2 
DF OVERFLOW, SET TO 3 
BB UNCHANGED 








(J EXPONENT OVERFLOW OP 2 NOT ON HALF-WORD BOUNDARY 

CO EXPONENT UNDERFLOW OP 2 NOT ON FULL-WORD BOUNDARY 

C2 FIXED-POINT DIVIDE OP 2 NOT ON DOUBLE-WORD 

OC FIXED-POINT OVERFLOW BOUNDARY 

C1 FLOATING-POINT DIVIDE OP 1 NOT EVEN NUMBERED REGISTER 

(J opeRATION OP 1 NOT ODD NUMBERED REGISTER 
NONE 





The extended mnemonic codes are used like the branch on condition (8.5) instruction 
(checkoff table for BC instruction is shown above). Extended mnemonics are the shorthand 
version of the branch on condition (BC) instruction. They are easy to use because you do 
not need to remember the decimal value that is associated with the operand 1 mask of the 
branch on condition instruction. You merely remember the mnemonic. The extended 
mnemonics create the mask value, which tests the condition code. If the specific condition 


or conditions you want to branch on exist, a branch is made to the address specified in 
operand 2. 


Before a branch is made, the address of the running program is saved, thus enabling you 
to return to that point if desired. It is a good idea to familiarize yourself with the branch on 
condition instruction and Table 8—1 before you use the extended mnemonics. 


Table 8—1 is a listing of the extended mnemonic codes. The hexadecimal operation codes 
(with mask) and functions, categorized by instruction type, are grouped according to use. 
Also included are the branch on condition (BC) instruction equivalents. An example of a 
hand-written coding form follows. 
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Example: 
LABEL AOPERATIONA OPERAND 
1 10 16 
1. cP A,B 
F BE EQUAL 
3. BL LOW 
BH HIGH 
LOW AP A,B 
A DC Pik! 
B pc P's! 


1. The compare decimal (CP) instruction compares the packed decimal contents of A 
against the packed decimal contents of B. Based on the results, the condition 
code in the PSW is set to 1 (operand 1 < operand 2). 


2. The next sequential instruction executed is branch if equal (BE). The mask (8) 
tests for condition code O (operand 1 = operand 2). Since the condition is not 0, 
no branch is made, and the next sequential instruction is executed. 


3. Since no branch was made, the next sequential instruction executed is branch if 
low (BL). The mask (4) tests for condition code 1 (operand 1 < operand 2). Since 
the condition code is 1, a branch is made to the operand 2 address (LOW). In this 
example, LOW is the address of an add decimal instruction, which is the 
instruction executed after the BL instruction. 


Table 8—1. Extended Mnemonics and Functions (Part 1 of 2) 


Note that the next sequential instruction is branch if high (BH), but it is not 


executed after the BL instruction. 
Mnemonic meneciectne Mnemonic Hexedécimna: Explicit 
Operation Operation 
Code Code Form 
Code/m, Code/m, 


Used to Branch Around Nonexecutable Assembler Instructions and Directives 
































15,r 
BCR 0,15 
15,dg(x5,b5) 
0,do{x,,b5) 


Branch unconditionally 
No operation 

Branch unconditionally 
No operation 


2 
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Table 8—1. Extended Mnemonics and Functions (Part 2 of 2) 


RR-Type Instructions RX-Type Instructions BC Equivalent 


Hexadecimal Hexadecimal 















Mnemonic 
Code 


Mnemonic 
Code 


Explicit 
Form 










Operation 
Code/m, 


Operation 





Code/m, 
Used After Comparison instructions 


2,dy(x5,b5) Branch if high 
4,do(x5,b9) Branch if low 
8,do(x5,b5) Branch if equal 
13,d5(x5,b5) Branch if not high 
1 1,d9(x5,b5) Branch if not low 
7.do(x5,b5) Branch if not equal 






























Used After Test-Under-Mask Instructions 






1,d5(x5,b5) Branch if all ones 











8,d5(x5,b5) Branch if all zeros 
4,do(x5,b5) Branch if mixed 
14,do(xo,b5) Branch if not all ones 
7 do (x%o,b5) Branch if not all zeros 





11,do(x5,b5) Branch if not mixed 


Used After Arithmetic Instructions 





Ido (x5,b9) Branch if overflow 
8,d5(x5,b5) Branch if zero 
4do(x5,b9) Branch if minus 
2,d5(x5,b5) Branch if positive 


14,d5{x5,b9) Branch if not overflow 
7do(x5,b5) Branch if not zero 
11,do(x5,b5) Branch if not minus 
13,d5(x5,b5) Branch if not positive 

















UP-8061 Rev. 3 SPERRY UNIVAC OS/3 8-5 
ASSEMBLER 








BAS 
BASR 


8.3. BRANCH AND STORE (BAS, BASR) 


OBJECT |] 7 ADDRESSING LC) PROTECTION 
INS: C1 DATA (INVALID SIGN/DIGIT) | [] SIGNIFICANCE 






































OPCODE FORMAT 










TYPE LGTH. 
(BYTES) || LJ DECIMAL DIVIDE (] SPECIFICATION: 
BAS ap TR OC DECIMAL OVERFLOW [C1 NOTA FLOATING-POINT REGISTER 
bas {4p + Rx _+_4_ OD execute [) OP 1 NOT ON HALF-WORD BOUNDARY 
—— CO EXPONENT OVERFLOW [1 oP 2 NOT ON HALF-WORD BOUNDARY 
O EXPONENT UNDERFLOW O OP 2 NOT ON FULL-WORD BOUNDARY 
Fhe Secuieon Ger oo C0 FIxXED-POINT DIVIDE (] = op 2 NOT ON DOUBLE-WORD 
Oe RESULT <0, SET 70.4 C FIxED-POINT OVERFLOW 4 BOUNDARY 
Cir ResuLT >o, SET TO 2 CO FLOATING-POINT DIVIDE OP 1 NOT EVEN NUMBERED REGISTER 
Otte OVERFLOW, SET TO 3 (0 OPERATION O OP 1 NOT ODD NUMBERED REGISTER 
UNCHANGED @ None 


The branch and store (BAS, BASR) instructions do not exist in the native mode set and are 
used only when operating in the 360/20 compatibility mode. They operate in the same 
way the branch and link instructions (8.4) operate (i.e., operand 1 contains the address of 
the program after executing the branching instruction but before executing the instruction 
you branched to). Operand 2 contains the address of the instruction executed immediately 
after the branching (BAS, BASR) instruction. 
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BAL 
BALR 


8.4. BRANCH AND LINK (BAL, BALR) 


Possible Program Exceptions 


















OPEQDE M oH C ADDRESSING Cl PROTECTION 
eevee | corn, |) DPATAUNVALID siIGN/DIGIT)| LD SIGNIFICANCE 
| wnem, [HEX.| (BYTES) {| OC ORCIMAL DIVIDE CD sPecIFICATION: 


NOT A FLOATING-POINT REGISTER 

OP 1 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON FULL-WORD BOUNDARY 


OP 2 NOT ON DOUBLE-WORD 
BOUNDARY 


OP 1 NOT EVEN NUMBERED REGISTER 
OP 1 NOT ODD NUMBERED REGISTER 


C1 DECIMAL OVERFLOW 

DO Execute 

(J EXPONENT OVERFLOW 
CO EXPONENT UNDERFLOW 
0 FIXED-POINT DIVIDE 

DO FIXED-POINT OVERFLOW 
[] FLOATING-POINT DIVIDE 
(J OPERATION 


BAL Pas ax 
BALR | 05 [| RR {| 2 | 


Condition Codes 


OIF RESULT = 0,SET TOO 
Olir Resutt <o, SET TO1 
Ctr RESULT >0O, SET TO2 
OIF OVERFLOW, SET TO3 
BE UNCHANGED 


O 
O 
O 
O 
0 
O 
0 
a 


NONE 





The branch and link (BAL and BALR) instructions alter the normally sequential execution 
of instructions by branching to an address you specify in operand 2. The instruction 
located at that address is the next instruction executed after the branch and link 
instruction. Before the branch is made, the address of the next sequential instruction 
(current location) is saved in the operand 1 register to enable you to return to the location 
where you were before branching. 


Explicit Format: 







A OPERATION A OPERAND 


[symbol] 


[symbol] Pils 


Implicit Format: 







A OPERATION A OPERAND 


[symbol] 
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Example 1 (BAL): 
LABEL AOPERATIONA OPERAND 
1 10 16 
6, BRANCHTO 
A,B 
3.| BRANCHTO CP A,B 
A DC P'65h! 
B oc P'}23' 


1. In this coding example, the BAL instruction alters the sequential execution of 
instructions by causing a branch to an area in main storage labeled BRANCHTO. 
Before the branch, the address of the next sequential instruction is stored in 


register 6 (location of NEXTSEQ). 


2. Since a branch took piace, the normally sequential execution of the add decimal 


(AP) instruction (NEXTSEQ) is skipped. 


3. This compare decimal (CP) instruction is processed immediately following the 
BAL instruction, since its label (BRANCHTO) is the branch-to address (operand 2) 


of the BAL instruction. 


Example 2 (BALR): 


} LA ROUTINE 
2. BALR 6,4 
NEXTSEQ AP A,B 
ROUTINE CP NUM,=P'15! 
BL LOW 
BH HIGH 


NUM DC P'26' 
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1. This load address (LA) instruction puts the address of an instruction labeled 
ROUTINE (CP) into register 4. 


2. The BALR instruction stores the address NEXTSEOQ in register 6, then branches 
to the branch address in register 4. Since register 4 is the address of ROUTINE, 
the instruction following the BALR instruction is compare decimal (CP). 


Operational Considerations: 


= You may specify any of the general registers (O through 15) as operand 1 in both the 
BAL and BALR instructions, and any of these registers as operand 2 of the BALR 
instruction. 


= The address of the instruction following the BAL or BALR instruction is placed in the 
operand 1 register. Then the branch to the address specified in operand 2 is made. 


a If you specify O as operand 2 of a BALR instruction, it means you are not specifying a 
branch-to address, and, therefore, no branch takes place. The instruction executed 
after the BALR is the next instruction in sequence. 


8.4.1. Use of the BALR Instruction in Base Register Assignment 
The BALR instruction is used in conjunction with the USING directive (see 18.2) to assign 


a base address to a register. This address becomes the starting address of your program. 
The BALR instruction and the USING directive must be coded in the following order: 


LABEL AOPERATIONA OPERAND 
l 10 16 
BASEREG START ) 
BEGIN BALR 3,6 
USING * 3 
OPEN INFILE ,OUTFILE 
READ GET INFILE 


The BALR instruction in this example stores the address of the next sequential instruction 
(OPEN) in register 3. No branch takes place since O is specified as operand 2. Logically, 
the address of the USING directive should be stored in register 3, since that is the next 
instruction. However, USING is a directive and not an executable instruction. Directives 
are information to the assembler only. They do not generate any object code nor increase 
the location counter. Therefore, OPEN is the next executable instruction following the 
BALR instruction. 


The USING directive tells the assembler that register 3 is going to be used as the base 
register for this program. Register 3 can accommodate a program up to 4096 bytes in 
length. If your program is larger than this, additional base registers can be assigned. (See 
18.2.) Operand 1 tells the assembler at what point in your program your base register 
should start being used. The asterisk (*) means “start now’. So, operand 1 indicates 
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starting now, all addresses of the following instructions will use the register specified by 
operand 2 (in this case, 3) as the base register. 


In the following printout example, an LA instruction (line 3) is coded after the BALR 
instruction, causing an addressability error. The BALR instruction (line 2) stores the 
address of the next sequential instruction (LA) in register 3. No branch takes place since O 
is specified as the operand 2 register. At location counter 000002, no object code was 
generated for the LA instruction because the assembler does not assemble an erroneous 
instruction. It does, however, increase the location counter by the number of bytes that 
that instruction occupies. Now, register 3 contains the address of the LA instruction at 
000002 but the USING directive (line 4) tells the assembler that starting at location 
counter 000006, all succeeding instructions will use register 3 as the base register. The 
USING directive assumes that register 3 contains the address at location counter O0O0006 
but in reality contains the address at location counter OOOOO2. So, all the addresses of 
every instruction and label in this program will be calculated as being four bytes more 
than its actual location. Therefore, the BALR instruction and USING directive must always 
refer to the same address so that the base and displacement values can be accurately 
calculated. 


Example: 


LOC. OBJECT CONDE ADDR1 ADDR2 LINE SOURCE STATEMENT 


000000 1 TSTUSING START 0 
000000 0530 2 BEGIN BALR 
000002 0000 0000 3 LOAD LA 
#wkAk ERROR xx 

000006 4 USING 

5 OPEN PRINT 
000006 0700 6+ CNOP 0,4 
000008 4510 300A 1, *+(4*2) 
o00000c 80 8+ X'80! 
000000 000060 9+ AL3 (PRINT) 
000010 0A26 38 ISSUE SVC 


38 PRINT DTFPR IOAREAI=OUTPUT , BLKS 1 ZE=1 32 


o000BC 90 LIST 
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BC 
BCR 


8.5. BRANCH ON CONDITION (BC, BCR) 


OBJECT 
OPCODE FORMAT | INST. 
TYPE LGTH. 


Possible Program Exceptions 


(J ADDRESSING C PROTECTION 

(J DATA (INVALID SIGN/DIGIT) | (] SIGNIFICANCE 

(1) DECIMAL Div!IDE CO SPECIFICATION: 

OC DECIMAL OVERFLOW NOT A FLOATING-POINT REGISTER 
D execute OP 1 NOT ON HALF-WORD BOUNDARY 
(CO EXPONENT OVERFLOW OP 2 NOT ON HALF-WORD BOUNDARY 
CJ EXPONENT UNDERFLOW OP 2 NOT ON FULL-WORD BOUNDARY 
CJ F1xXED-POINT DIVIDE OP 2 NOT ON DOUBLE-WORD 


(0 FIXED-POINT OVERFLOW BOUNDARY 
C1] FLOATING-POINT DIVIDE OP 1 NOT EVEN NUMBERED REGISTER 


(1 oPERATION OP 1 NOT ODD NUMBERED REGISTER 
NONE 


























MNEM. (BYTES) 


Condition Codes 


OF RESULT = 0, SET TOO 
Oe REsuLT <o, set to 1 
DJF RESULT > 0, SET TO 2 
Cir OVERFLOW, SET TO3 
HE UNCHANGED 























BOO ooooo0 


The branch on condition (BC and BCR) instructions change program sequence based on 
the condition code setting of the PSW. You specify in the operand 1 mask a decimal value 
that tests the condition code to see whether the branch-causing condition exists. If the 
condition of the branch does exist, a branch is made to the operand 2 address you specify 
in the branch on condition instruction. If the condition of the branch does not exist, no 
branch takes place, and the next sequential instruction is executed. 


Explicit Format: 







A OPERATION A 





LABEL OPERAND 





[symbol] 
[symbol] 


m,,d2(xz,b2) 


m/l 


Implicit Format: 











LABEL A OPERATION A 
[symbol] 
{symbol] 


OPERAND 


The condition code, bits 34—35 of the PSW, reflects the result of an instruction executed 
prior to the branch on condition instruction. There are four possible condition code 
settings: 

If result = O, set to O. 

If result < O, set to 1. 

If result > O, set to 2. 


tf overflow, set to 3. 
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The decimal values that can be specified in the operand 1 mask are O through 15, each of 
which has a 4-bit binary representation. 


= = =6 The decimal value 8 (1000) tests for condition code 0. 


= The decimal value 4 (0100) tests for condition code 1. 
= The decimal value 2 (0010) tests for condition code 2. 
a 


The decimal value 1 (0001) tests for condition code 3. 


Note that only one bit is set for each condition. When more than one bit is set in the 4-bit 
binary configuration, it is possible to test for multiple conditions. 


8 4 2 1 decimal 


binary 





The decimal value 10 tests for: 
(a) condition code O (result is equal to zero) and 
2) condition code 2 (result is greater than zero) 
Table 8—2 lists the 16 values and each condition code it tests. 


Table 8—2. Operand 1 Mask Combinations 


Results 


Possible Combinations of Branches on Causing 
Decimal Binary Condition Codes Condition Code Bisnch 
Value Value 


no operation None 

Overflow 

>0 

>0 or overflow 
<o 

<0 or overflow 
#0 

#0 or overflow 
=0 

= 0 or overflow 
20 

20 or overflow 
<0 

<0 or overflow 
Any value 

Any value or overflow 


w 


NNW 


oOomnonoahwnh—_ Oo 
OAN OoRWNH — * 
w 


11=8+2+1 
12=8+4 

13 =8+4+1 
14=8+4+2 
15=8+4+2+1** 


3 
2 
2 
1 
1 
1 
1, 
0 
0 
0 
8) 
0, 
0 
0 
0 





*No condition code is tested and no branch takes place. The next 
sequential instruction is executed. 


**Unconditional branch 
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Table 8—3 lists the explicit format of the BC instruction with different mask values and & 


their relation to the condition tested. 


Table 8—3. Branch-on-Condition Instruction by Usage 


Hexadecimal 


Operation 
Code m, 


Mnemonic Explicit 
Code Format 


Used to Branch Around Nonexecutable Assembler Instructions and Directions 


15,r5 

Or, 
15,d5(x5,b>) 
0,d5(x5,b5) 


Branch unconditionally 
No operation 
Branch unconditionally 
No operation 


Used After Comparison Instructions 


2,do(x,b5) 
4,do(xo,b5) 
8,do(x5,b5) 
13,d5(x5,b9) 
1 1,do(x5,b5) 
7,do(x5,b9) 


Used After Test-Under-Mask Instructions 


1,do{x5.b5) 
8,do(x5,b5) 
4,do(x5,b5) 
14,do(x5,b5) 
7.do(x5,b5) 
11 do(x5,b5) 


Branch if high 
Branch if low 
Branch if equal 
Branch if not high 
Branch if not low 
Branch if not equal 





Branch if all ones 
Branch if all zeros 
Branch if mixed 
Branch if not all ones 
Branch if not all zeros 
Branch if not mixed 


Used After Arithmetic Instructions 


Operational Consideration: 


1 d9(x5,b5) 
8,d5(x5,b5) 
4.do(x5,b5) 
2,do(x5,b5) 


14,d5(x5,b5) 
7,do(xo,b5) 

1 1,d5{x5,b5) 
13,do{x5,b5) 





Branch if overflow 
Branch if zero 

Branch if minus 
Branch if positive 
Branch if not overflow 
Branch if not zero 
Branch if not minus 
Branch if not positive 


= You can specify any of the general registers (2 through 12) as operand 2 of the BCR 


instruction. 
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@ Example (BC): 

LABEL AOPERATIONA OPERAND 
1 10 16 

1. cP A,B 

2. BC 2,HIGH 

3 BC L LOW 

4, BC 8, EQUAL 

S.| EQUAL AP A,C 
A bc P'659' 
B DC P'656' 
C oc Pi]! 


In this example, two packed decimal values are compared. After the result is obtained, 


the condition code is stored in the PSW. The branch instructions are executed 
sequentially, and when the proper condition for the branch-on condition exists, a 
branch to the operand 2 address takes place. 


1. 


Operands 1 and 2 compare equally since both A and B contained the packed 
decimal 650. The condition code is set to O. 


The operand 1 mask 2 tests for condition code 2. Since the condition code is not 
2 (operand 1 > operand 2), the next sequential instruction is processed. 


The operand 1 mask 4 tests for condition code 1. Since the condition code is not 
1 (operand 1 < operand 2), the next sequential instruction is processed. 


The operand 1 mask 8 tests for condition code 0. Since the condition code is O 
(operand 1 = operand 2), a branch to the address of operand 2 (EQUAL) takes 
place. 


Since the add decimal instruction has the label EQUAL, that is the instruction 
executed after the branch-on condition regardless of the sequential instructions 
in between. 
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BCT 
BCTR 


8.6. BRANCH ON COUNT (BCT, BCTR) 


Possible Program Exceptions 


OBJECT || ADDRESSING OD prROTECTION 


OPCODE 
i isin ru ( DATA (INVALID SIGN/D1GIT) | [] SIGNIFICANCE 


(BYTES) |] LJ DECIMAL DiviDE OC sPeciF ication: 
DC DECIMAL OVERFLOW 
DC EXECUTE 


NOT A FLOATING-POINT REGISTER 
OP 1 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON FULL-WORD BOUNDARY 
OP 2 NOT ON DOUBLE-WORD 
BOUNDARY 
OP 1 NOT EVEN NUMBERED REGISTER 
OP 1 NOT ODD NUMBERED REGISTER 
NONE 


(CL) EXPONENT OVERFLOW 
Condition Codes C0 EXPONENT UNDERFLOW 
CJ iF RESULT = 0,SET TOO CL EIXED POINT DINIDE 
Cir RESULT <0, SET TO1 CJ FIXED-POINT OVERFLOW 
Clif RESULT > 0, SET TO 2 (J FLOATING-POINT DIVIDE 


CF OVERFLOW, SET TO 3 CJ OPERATION 
Wi UNCHANGED 





BOO oooo0 


The branch on count (BCT and BCTR) instructions branch to the same instruction or 
routine a number of times (loop). Normally, before you execute a branch on count 
instruction, you load one of the general purpose registers with a value (the count) that 
refers to the number of times you want to loop to an instruction or routine. You specify the 
register containing the counter as operand 1 in your branch on count instruction. Each 
time the branch on count instruction is executed, the operand 1 register is decremented by 
one. Then the register is checked for a value of zero. If zero is not found, a branch to the 
instruction at the operand 2 address takes place. If the counter is O, no additional 
branching takes place, and the next sequential instruction is executed. You can use the 
BCTR instruction to decrement the counter register (operand 1) without branching, by 
specifying the operand 2 register as O. When BCTR is executed, the value in the operand 1 
register is decremented by 1, but since no branch address is supplied, the next sequential 
instruction is executed. 


Explicit Format: 









A OPERATION A OPERAND 





r,,d,(x,,b,) 


rT, 


[symbol] 
[symbol] 





Implicit Format: 





A OPERATION A OPERAND 






[symbol] 


{symbol] 1Gts 
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Example: 
LABEL AOPERATIONA OPERAND 
] 10 16 
1. SR 6,6 
2. LA 6,16 
3.1 BRANCHTO AP SUM , AMOUNT 
k, BCT 6, BRANCHTO 
NEXTSEQ MP SUM, VALUE 
AMOUNT DC P'15¢' 
SUM Dc PL3'@! 


This coding example adds AMOUNT (150) to SUM 10 times and stores the result in 
SUM (3-byte field). 


1. The subtract (SR) instruction subtracts the operand 2 register value from the 
operand 1 register value and puts the result in operand 1. In this case, register 6 
is subtracted from itself, thus making it O. It is a good idea to clear a register 
before using it. 


2. The /oad address (LA) instruction loads a count of 10 into register 6. 


3. The add decimal (AP) instruction adds the packed decimal value in AMOUNT 
(150) to whatever is stored in SUM and stores the answer in SUM. SUM is 
defined as a packed decimal constant containing O. After the AP instruction is 
executed once, SUM contains 150. 


4. The BCT instruction subtracts 1 from register 6. Since register 6 now contains 9, 
the AP instruction labeled BRANCHTO is executed again. After the AP is 
executed twice, SUM contains 300. The BCT instruction executes nine more 
times until the counter (register 6) is O. On the tenth attempt, no branch takes 
place, and NEXTSEQ is executed. 


Operational Considerations: 


= The maximum value you can specify in the operand 1 counter register is 232. 


1. You can specify any of the general registers (0 through 15) as operand 1. 


= You can specify the operand 2 register of the BCTR instruction as O if you want to 
decrement the operand 1 counter register by 1 without causing a branch. When you 
specify O in operand 2, the next sequential instruction of your program is executed 
following the BCTR. 


® The branch-to address in operand 2 is determined before the operand 1 register is 
decremented. 





UP-8061 Rev. 3 SPERRY UNIVAC OS/3 8—16 
ASSEMBLER 





EX 





8.7. EXECUTE (EX) 


Possible Program Exceptions 


— ADDRESSING PROTECTION 

(J DATA (INVALID SIGN/DIGIT)| [] SIGNIFICANCE 

(CD DECIMAL DIVIDE WB SPECIFICATION: 

ZC DECIMAL OVERFLOW NOT A FLOATING-POINT REGISTER 
MexecuTte ~ OP 1 NOT ON HALF-WORD BOUNDARY 
(EXPONENT OVERFLOW OP 2 NOT ON HALF-WORD BOUNDARY 
CD ExPONENT UNOERFLOW OP 2 NOT ON FULL-WORD BOUNDARY 
CO F1xXED-POINT DIVIDE OP 2 NOT ON DOUBLE-WORD 


OC] FIxED-POINT OVERFLOW BOUNDARY 
1 FLOATING-POINT DIVIDE OP 1 NOT EVEN NUMBERED REGISTER 


C opeRATION OP 1 NOT ODD NUMBERED REGISTER 
NONE 


OBJECT 
OPCODE FORMAT | INST. 


TYPE LGTH. 
(BYTES) 


Condition Codes 


Clif RESULT = 0,SET TOO 
Cir RESULT <0, SETTO1 
OJif RESULT > 0, SET TO 2 
CIF OVERFLOW, SET TO 3 
SEE OPER. CONSIDERATIONS 









The execute (EX) instruction is used to branch to an instruction elsewhere in your 
program, execute it with or without having modified it temporarily, and then branch back 
to the instruction following the EX instruction. & 





Explicit Format: 






A OPERATION A OPERAND 


[symbol] 


Implicit Format: 


LABEL A OPERATION A OPERAND 


[symbo!] 





The address specified by operand 2 is the address of the instruction to which you branch 
following the EX instruction. This instruction, specified by operand 2, is called the subject 
instruction. The operand 1 register determines whether or not change will be made to the 
subject instruction before execution. If register O is specified as the operand 1 register, no 
change is made to the subject instruction and it is executed following the EX instruction 
as if it were the next sequential instruction. 


On the other hand, if any register other than zero is specified, bits 8 through 15 of the 
subject instruction are changed. This change is accomplished by the logical addition OR on 
the contents of bits 24 through 31 of the operand 1 register that you previously loaded 
and the contents of bits 8 through 15 of the subject instruction. (See logical OR 
instruction.) The result is placed in bits 8 through 15 of the subject instruction. The 
contents of the operand 1 register remain unchanged. Moreover, the change to the subject 
instruction is temporary and effective only during this execution of the subject instruction. 
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The instruction address and instruction length of the current PSW is changed by the 
execution of the EX and subject instruction. Normally, instruction sequencing continues 
with the instruction following the EX instruction. However, if the subject instruction is a 
successful branch instruction, the instruction address of the current PSW is replaced by 
the branch address and instruction sequencing resumes with the instruction address 
specified by the branch. If the subject instruction is a BAL or BALR, instruction sequencing 
resumes with the instruction address specified by the link register. 


EX Instruction: 
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Operational Considerations: 


# It isn’t a good idea to alter instructions, but if it’s absolutely necessary, you can use 
the EX instruction for that purpose. 
= You can specify any of the general registers (O through 15) as operand 1. 
= Before the EX instruction causes a branch to the address you specify in operand 2, 
the current program address is stored in the PSW. Unless the branch to instruction 
(operand 2) is a successful branch instruction, sequential instruction execution 
follows execution of the subject instruction. 
= ~=If a program interrupt occurs after completion of the subject instruction, the old PSW 
contains either the address of the instruction following the EXECUTE or, in the case 
of a successful branch, the branch address. The current PSW contains the address of 
the instruction causing the interrupt (i.e., the operand 2 address in the EX instruction, 
or the branch-to address if a successful branch occurred before the interrupt). 
= If the subject instruction is another EX instruction, a program exception occurs. 
= A program exception can be caused by either the EX instruction itself or by the 
subject instruction. 
s The condition code can be set by the subject instruction. 
Example: 
LABEL AOPERATIONA OPERAND 
1 10 16 
L 4 =F 3! 
EX k MOVE 
PUT PRINT 
MOVE MVC 6(8,5) , INPUT 
DS OH 
INPUT DS CL86 


PRINT DTFPR IOAREAT=OUTPUT , BLKS 1 ZE=1] 32 , SAVAREA=SAVE 
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MOVE before execution 
of EX instruction and 
after execution of MVC 
instruction: 


1 2 3 and 4 5 and6 
8915 
| l 
0000 ' 0000 | 0000 ' o000 | 0000 | 0000 | 0000 ' 0011 
24~+—+31 


wows coon 8 TT ee 


instruction: 









Register 4 before and 
after execution of EX 
instruction: 


In the preceding coding example, register 4 is loaded with a value of 3. The EX instruction 
is executed. Register 4 indicates that change will be made to the subject instruction 
(MOVE). A branch is made to the subject instruction and a logical addition OR is 
performed on the contents of bits 24 through 31 of register 4 and the contents of bits 8 
through 15 of the MVC instruction. The result is placed in bits 8 through 15 of the MVC 
instruction only for the duration of this execution of the MVC instruction. After execution 
of the MVC instruction is completed, a branch is made back to the instruction following 
the EX (PUT), and processing continues. 
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9. Decimal and Logical Instructions 


9.1. USING DECIMAL INSTRUCTIONS 


Decimal instructions perform arithmetic calculations on data located in main storage, 
using storage-to-storage instruction format. You must put decimal numbers into main 
storage before attempting to use them in mathematical calculations. Storage-to-storage 
instructions do not allow the use of general registers for calculations, since registers 
-handle binary, not decimal, numbers. Decimal instructions are slower than instructions 
that use general registers (binary arithmetic, floating-point, etc.), because two main 
storage locations (specified in the operand fields) are accessed each time a decimal 
instruction is executed. 


In assembly language, decimals are expressed in either unpacked or packed format. 
Format refers to the way bits represent decimal numbers. Unpacked format is the standard 
form in which numbers are brought in to the system (input), and sent out from the system 
(output). Packed format is the standard form in which numbers are used in mathematical 
calculations. 


Numbers written in unpacked format are movable from one location in main storage to 
another and are printable on input and output devices. Arithmetic operations, however, 
can only make use of packed decimal numbers. Therefore, you must pack each number 
before you use it. In turn, you must then unpack the number before you output it (either to 
a printer or any other character sensitive device). 


Unpacked format uses eight bits to represent a decimal number. The leftmost four bits are 
the zone field, and the rightmost four bits are the decimal digit in binary. 





The zone portion of a number is always a binary 1111 which is a hexadecimal F. The F in 
the zone field indicates that any decimal digit (O—9) in the digit field is a numeric 
character in EBCDIC (Extended Binary Coded Decimal Interchange Code). These 
relationships are shown in the following chart. 
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Binary 
Code 


11110000 
11110001 
11110010 
11110011 
11110100 
11110101 
11110110 
11110111 
11111000 
11111001 





Decimal Hexadecimal 
Digit (EBCDIC) Code 
O FO 
















OMDNMORWNH— 


Since decimal operations require the number you use to be in packed format, the decimal 
numbers must be defined as packed constants or converted from unpacked to packed 
format. To convert from unpacked to packed format, use the pack decimal (PACK) 
instruction. The PACK instruction removes the zone bits of the unpacked decimal, thus 
expressing the same value in fewer bytes of main storage. 


In both unpacked and packed formats, the sign is expressed in the rightmost byte which is 
the zone portion in unpacked format and the rightmost digit portion in packed format. 


The hexadecimal numbers A through F can be sign values that are either positive or 
negative, and are used in either ASCII or EBCDIC mode. A hexadecimal A and B are used 
for output of data in ASCII mode only. A represents a positive value and B represents a 
negative value. 


A hexadecimal C, D, and F are all used for internal processing in EBCDIC mode. C 
represents a positive value, D represents a negative value, and F represents an unsigned 
number which is assumed positive. If you attempt to print an unpacked decimal number 
with hexadecimal C or D as the sign value, an alpha character is printed for the rightmost 
byte instead of a decimal digit. Hexadecimal C and D must be changed to hexadecimal F 
either through the ED or OI instruction to print the correct value. 


A hexadecimal F is used for output of data in EBCDIC mode and represents an unsigned 
number which is assumed positive. 


The following illustrations represent a 3-digit decimal number in both packed and 
unpacked format. Notice the positions of the zone and digit portions: 


Unpacked Format: 


ae] fae [oe [om] 
ee Re ge 


byte 1 byte 2 byte 3 
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Packed Format: 


om] | 
ae me ee” 
byte 1 byte 2 


These illustrations represent the decimal number +456 in both packed and unpacked 
format. 


Unpacked: byte 1 byte 2 byte 3 
Ft tt a a 


Packed: 





byte 1 byte 2 


There is a zone portion for every digit and one sign value in unpacked format and only 
digits and one sign value in packed format. Notice the number of bytes the unpacked 
format occupies in contrast to the packed format. The decimal number +456 occupies 
three bytes when unpacked and only two bytes when packed. The sign value hexadecimal 
C indicates that 456 is a positive number. 


9.2. DEFINING PACKED AND UNPACKED CONSTANTS AND MAIN STORAGE 
AREAS 


You can specify packed or unpacked constants and reserve areas in main storage destined 
to hold packed decimal values by using the define constant (DC) and define storage (DS) 
statements. Their format is: 










A OPERATION A OPERAND 











[symbol] 


(al | 


[symbol] [d] ; 


Duplication factor ere! | 
Definition type 


Length factor 
Constant specification 


\ [Ln] ‘c’ 


P 
Zz 
F} teal Ce' 


In this format, symbol is an optional predefined label that names the location of the 
constant or main storage area. The symbol’s main storage address is the address of the 
leftmost byte of the constant or main storage area specified in the operand field. Relative 
addressing (symbol + 4) is acceptable. 
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The duplication factor d is a decimal number that tells the assembler how many times you 
want the constant reproduced or how many areas of the same length you want reserved 
in main storage. Specifying the duplication factor saves you the time of defining the same 
constant or area more than once. 


The definition type is P for packed or Z for zoned (unpacked), which indicates the type of 
constant or main storage area you are specifying. There are other definition types 
available, but are used for other applications (Table 5—1). 


The length factor Ln specifies the number of bytes of storage reserved for a constant (DC) 
or an area to be used in your program (DS). If no length is specified, the assembler assigns 
the length of the constant specified within apostrophes. By explicitly specifying a length, 
you can determine the lengths of all the fields in your program regardless of how large or 
small your constants are. 


The constant itself (c) is enclosed in apostrophes. In the case of a DS statement, the 
constant you enclose in the apostrophes is not actually generated, but its length 
determines the length of the main storage area allocated. Embedded blanks cannot be 
used in packed and zoned type constants. 


9.2.1. Packed Decimal Constants and Main Storage Areas 


When you specify packed decimal constants, the character P is the definition type in the 
operand field. Packed decimal constants can be up to 31 decimal digits (16 bytes) and can 
be signed or unsigned. If unsigned, the value is assumed to be positive. The address of the 
symbol you put in the label field is the address of the constant you define in the operand 
field. When you specify a packed decimal constant, the actual decimal value you specify is 
placed into main storage. 








Example: 
LABEL AOPERATIONA OPERAND 
] 10 16 
1.) NUM] DC P'+4563 ! 
2.1 NUM2 dC PL3'123' 
3.4 NUM3 DC 2PL2'123' 


1. This coding statement produces this packed decimal constant in main storage. 
The 3-byte length is implied since three bytes are needed to hold the constant 
and its sign. 
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2. This coding statement produces this packed constant in main storage. In this 
case, the 3-byte length isn’t needed to hold the constant, but since a length of 
three is specified, three bytes are allocated. The number is right-justified and 
thus the most significant unused bytes are zero-filled. 


3. This coding statement produces two consecutive, duplicate 2-byte constants in 
main storage. 


The character P also is the definition type for defining packed decimal storage areas (i.e., 
areas destined to hold packed decimal data). The address of the symbol you put in the 
label field is the address of the constant you define in the operand field. No actual 
constant is placed into the area you reserve, and the area is not cleared of any data it may 
already contain. You are merely reserving a main storage area for future use. 


Example: 
LABEL AOPERATIONA OPERAND 
] 10 16 
1.) NUM4 DS P'+4563' 
2.| NUM5S DS PL2 
3.1 NUM6 DS PL1'6! 


1. This coding statement reserves a 3-byte area in main storage. The statement 
does not put the packed decimal +4563 into that area but merely reserves an 
area large enough to hoid it. 


2. This coding statement reserves a 2-byte area in main storage. It does not clear 
the area or put anything into it. 


3. This coding statement reserves a 1-byte area in main storage. 


If you intend to reserve a packed storage area for mathematical calculations in either of 
these three ways, move zeros into the specified storage area to clear it of any leftover data 
from another program. This will ensure that mathematical calculations are performed 
correctly. 
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9.2.2. Unpacked Decimal Constants and Main Storage Areas 


When you specify unpacked decimal constants, the character Z is the definition type in the 
operand field. Unpacked decimal constants can be up to 16 decimal digits (16 bytes) and 
can be signed or unsigned. If unsigned, the value is assumed to be positive. The address 
of the symbol you put in the label field is the address of the constant you define in the 
operand field. When you specify an unpacked decimal constant, the actual decimal value 
you specify is placed into main storage as digits with zone fields of hexadecimal! F. 





Example: 
LABEL AOPERATIONA OPERAND 
1 10 16 
1.{ [symbol] DC Z'+4563 ! 
2.| [symbol] DC ZL5'123! 
3.| [symbol] DC 2ZL3'123! 


1. This coding statement produces this unpacked decimal constant in main storage. 
The 4-byte length is implied since four bytes are needed to hold the unpacked 
constant with zones and sign. 


ie tete [fe [ets 


2. This coding statement produces this unpacked decimal constant in main storage. 
In this case, the 5-byte length isn’t needed to hold the constant, but since a 
length of five is specified, five bytes are allocated. Note that the C in the 
rightmost byte represents a signed positive value. 


feet he oe] Se ei rea 


3. This coding statement produces two consecutive 3-byte constants in main 
storage. 


The character Z also is the definition type for defining unpacked decimal main storage 
areas (i.e., area destined to hold unpacked decimal data). The address of the symbol you 
put in the label field is the address of the main storage area you define in the operand 
field. No actual constant is placed into the area you reserve, and the area is not cleared of 
any data it may already contain. You are merely reserving a main storage area. 
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& Example: 


LABEL AOPERATIONA 





OPERAND 
| 10 16 
1.| ZNUMI DS Z'4543! 
2.) ZNUM2 DS ZL4 
3.1 ZNUM3 DS 2ZL4 


This coding statement reserves a 4-byte area in main storage. The actual 


unpacked decimal constant 4543 is not placed into the reserved area by this 
statement. 


This coding statement also reserves a 4-byte area in main storage. 


This coding statement reserves two consecutive 4-byte areas in main storage. 
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AP 


9.3. ADD DECIMAL (AP) 


General 


OBJECT 
INST. 
LGTH. 
(BY TES) 





HE ADDRESSING 

Hh DATA (INVALID SIGN/DIGIT) 
(J DECIMAL DIvIDE 

W@ DECIMAL OVERFLOW 

(] ExeCcuTE 

(J EXPONENT OVERFLOW 

C0 EXPONENT UNDERFLOW 





OPCODE 






FORMAT 
TYPE 







MNEM. |JHEX. 





SPERRY UNIVAC OS/3 





Possible Program Exceptions 


@ PROTECTION 
C1 SIGNIFICANCE 
CO SPECIFICATION: 


NOT A FLOATING-POINT REGISTER 

OP 1 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON FULL-WORD BOUNDARY 





Condition Codes 


WM if RESULT =0,SET TOO 








C] FIXED-POINT DIVIDE 

CJ FIXED-POINT OVERFLOW 
C) FLOATING-POINT DIVIDE 
{J OPERATION 


OP 2 NOT ON DOUBLE-WORD 
BOUNDARY 


OP 1 NOT EVEN NUMBERED REGISTER 
OP 1 NOT ODD NUMBERED REGISTER 


@ ie Resutt <o, set to1 
Wir RESULT >0, SET TO 2 
BB if OVERFLOW, SETTO3 
CO UNCHANGED 






OOO OOoO00 


z 
ie] 
z 
m 





The add decimal (AP) instruction algebraically adds the packed decimal contents of 
operand 2 (the sending field) to the packed decimal contents of operand 1 (the receiving 
field). The sum is stored in operand 1 and is filled, a byte at a time, from right to left. 


Explicit Format: 










A OPERATION A 





LABEL OPERAND 





[symbol] d, (I, ,b,),d, (I,,b,) 


implicit Format: 









A OPERATION A 





LABEL OPERAND 


[symbol] 





s, (I, ).82 (Ip) 
Operational Considerations: 
= The value and sign of the sum are algebraically, not logically, calculated. 


m™ Since the sum is stored in the operand 1 location and if the length of the sum is 
greater than the length of operand 1, the leftmost digits of the sum are truncated. 


Example: 
LABEL AOPERATIONA OPERAND 
] 10 16 
AP A,B 
A DC P'2' 
B oc p'g! 
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A before AP execution: 21¢C 
B before and after AP execution: 91C 
A after AP execution: + 1 


As shown, the entire sum (11) does not fit into the one byte allocated in operand 1, so the 
leftmost digit of the sum is lost. If the operand field of the DC statement defining A is 
changed to PL2‘2’, two bytes are allocated for the sum, and the correct 2-byte sum fits 
into the allocated area. If the sum does not fill the length specified in operand 1, zeros fill 
the remaining leftmost bytes of operand 1. A zero sum is positive as long as the length of 
operand 1 is large enough to hold the entire sum (i.e., no leftmost digits are lost). If the 
sum is zero and the leftmost digits are lost, the sign is the sign of the sum before the 
digits were lost. It is possible to double a number (add it to itself) when the rightmost bytes 
of operands 1 and 2 have overlapping bytes in main storage. 





Example: 
LABEL AOPERATIONA OPERAND 
] 10 16 
AP A,A 
A OC P'1234! 


byte 1 byte 2 byte 3 


A before AP execution: 
A after AP execution: s 5 [a re ee 


The entire contents of A is extracted, doubled and the answer returned to the same field. 
This destroys the original contents of A. 
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CP 


9.4. COMPARE DECIMAL (CP) 


OBJECT || gy ADDRESSING Wi PROTECTION 


OPCODE FORMAT | INST 
i INVALID SIGN/DIGIT SIGNIFICANCE 
TEE edi: Hh DATA (INVALID SIGN/D IO 


(Bytes) || (J DECIMAL DiviDE CL) SPECIFICATION: 
(2) DECIMAL OVERFLOW NOT A FLOATING-POINT REGISTER 
O] execute OP 1 NOT ON HALF-WORD BOUNDARY 


(1 EXPONENT OVERFLOW OP 2 NOT ON HALF-WORD BOUNDARY 
C0 EXPONENT UNDERFLOW OP 2 NOT ON FULL-WORD BOUNDARY 
CO FIXED-POINT DIVIDE OP 2 NOT ON DOUBLE-WORD 
+ ree ean oes D0 F1xXED-POINT OVERFLOW BOUNDARY 
iF ori >or2, Serres (J FLOATING-POINT DIVIDE OP 1 NOT EVEN NUMBERED REGISTER 


Clr OVERFLOW, SET TO 3 (0 OPERATION OP 1 NOT ODD NUMBERED REGISTER 
(J UNCHANGED NONE 





The compare decimal (CP) instruction is used to compare operand 1 to operand 2, byte-by- 
byte from right to left. The result determines the setting of the condition code. (See 8.1.) 


Explicit Format: 






A OPERATION A OPERAND 








[symbol] d, (1, b, ).d, (I, ,b, ) 





Implicit Format: 


LABEL A OPERATION A OPERAND 


[symbol] s, (I, ),s, (I) 





Based on the comparison result, the condition code of the program status word (PSW) is 
set to 1 if operand 1 is less than operand 2, to 2 if operand 1 is greater than operand 2, 
and to O if operands 1 and 2 are equal. 


The condition code is part of the PSW, a double-word register that holds information 


pertinent to instruction execution. The instruction executed following the CP instruction 
depends on the condition code setting. The four condition code settings are as follows: 


Condition Code Bit Configuration 
(Decimal Value) (Bits 34—35 of PSW) 


00 = test value is binary 8 (1000) 


01 = test value is binary 4 (0100) 
10 = test value is binary 2 (0010) 
11 = test value is binary 1 (0001) 
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Operational Considerations: 


The CP instruction compares the rightmost byte of the operands first, and then works 
to the left one byte at a time. 


If operand 1 is shorter than operand 2, or operand 2 is shorter than operand 1, zeros 
fill the leftmost bytes of the shorter operand, thus making the operands the same 
length during the comparison. Even though zeros are added, neither operand is 
permanently changed by the instruction. 


Any zero compares equal to another zero regardless of their signs. 


Positive signs compared to each other compare as equal; and the same holds true for 
negative signs. 


It is possible to compare a decimal, or part of a decimal to itself, or part ot itself, by 
overlapping the location of the rightmost bytes of the operands in main storage. 








Example: 
LABEL AOPERATIONA OPERAND 
1 10 16 
cp A+2 (2) ,A+3(1) 
A DC PL4'1234567'! 
Operand 1 

A before and after execution SSS Peas 

of CP instruction: ae pe ee ae a 
eS ee” 
Operand 2 


In this example, the packed decimal contents of operand 1 are compared to the packed 
decimal contents of operand 2. Operands 1 and 2 have overlapping rightmost bytes. The 
processor temporarily adds a byte of zeros to operand 2 since operand 2 has fewer bytes 
than operand 1. After the CP instruction is executed, the condition code is set to 2 
because operand 1 is greater than operand 2. 
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DP 


9.5. DIVIDE DECIMAL (DP) 


OBJECT |) my ADDRESSING Mi PROTECTION 
SP | ee eae. UNG Ml DATA (INVALID SIGN/DIGIT)| [) SIGNIFICANCE 
TYPE LGTH. 


(BYTes) || MP OECIMAL DivIDE Wi SPECIFICATION: 


ZC DECIMAL OVERFLOW NOT A FLOATING-POINT REGISTER 


OP 71 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON FULL-WORD BOUNDARY 


OP 2 NOT ON DOUBLE-WORD 
BOUNDARY 


OP 1 NOT EVEN NUMBERED REGISTER 
OP 1 NOT ODD NUMBERED REGISTER 


LC EXPONENT OVERFLOW 
Condition Codes C) EXPONENT UNODERFLOW 


El Paecue eee tou (J FIXED-POINT DIVIDE 
Cir RESULT <0, SET TO1 (CJ FIXED-POINT OVERFLOW 


Cir RESULT >0,SETTO2 C] FLOATING-POINT DIVIDE 
CIF OVERFLOW, SET TO 3 (J OPERATION 
BBUNCHANGED 





OOO OOOO00 


Zz 
ie) 
2 
m 


The divide decimal (DP) instruction divides the packed decimal contents of operand 1 
(dividend) by the packed decimal contents of operand 2 (divisor). The result (quotient and 
remainder) is stored in operand 1 (the receiving field) which is filled from right to left. 


Explicit Format: 






A OPERATION A OPERAND 





[symbol] d, (I, ,b, ),d, (I, ,b, ) 


Implicit Format: 









OPERAND 


LABEL A OPERATION A 


[symbol] 





s, (I, ),s, (tp) 
Operational Considerations: 


= Operand 1 contains both the quotient and the remainder after the DP instruction is 
executed. Since operand 1 is the receiving field for the result, it consists of two side- 
by-side fields. The remainder with sign occupies the rightmost field, and the quotient 
with sign occupies the leftmost field. The leftmost byte of the quotient is the address 
specified by operand 1, and the rightmost byte of the remainder is the rightmost byte 
specified by operand 1. 


= = =6©The quotient with sign and the remainder with sign are determined algebraically. The 
sign of the remainder takes its sign value from the sign of the dividend. 


= ~The length of the dividend is restricted to 16 bytes and must have at least one leading 
zero in the leftmost portion. As a result, the most significant digit is always zero. The 
length of operand 1 should be sufficient to hold the quotient, the remainder, and their 
signs. 
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The divisor length is restricted to eight bytes. The operand 2 field, which holds the 
divisor, is unchanged aftér the DP instruction is executed. 


The length of the quotient is restricted to 15 bytes. This length is equal to the number 
of bytes needed to hold the dividend with sign and the divisor with sign (operand 1 + 
operand 2). 


The length of the remainder must be at least one byte. The length of the remainder is 
the length of the divisor and is therefore restricted to eight bytes. 


If the result is larger than the length specified for operand 1, or if you attempt to 
divide by zero, a decimal divide program exception occurs. 


If you want to reuse operand 1 for further mathematical calculations, you must move 
a packed field of zeros into the specified area to clear it of any leftover data. 


In fixed-point instructions, it is your responsibility to keep track of assumed decimal 
points. To add or delete decimal places, you can multiply or divide by powers of 10. 
You can also use the move with offset (MVO) instruction (see 9.9) to drop any number 
of leftmost digits you specify. 


Example: 








LABEL AOPERATIONA OPERAND 
] 10 16 
DP NUM] ,NUM2 

NUM] DC PL3'234' 
NUM2 DC P'2! 

leading 

zeros dividend 

NS 


NUM1 before execution 


: : Packed 
of DP instruction: fo 1 0 | 21 3 4 1cC decimal 


number 

divisor 
NUM2 before and after : Pcheel 
execution of DP instruction: 21 C decimal 
number 


: quotient : remainder 
NUM1 after execution a a Two packed 


of DP instruction: bee 71°C o'c decimal 


numbers 
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In this example, the packed decimal content of NUM71 is divided by the packed decimal 
content of NUM2. The result (quotient and remainder) replaces NUM1. Note the dividend is 
a 3-byte field containing leading zeros. Its length is calculated by adding the actual 
number of bytes required to hold the data in NUM1 (two bytes) and NUM2 (one byte) 
which gives a total of three bytes for the dividend. Since the divisor is one byte, the 
remainder also is one byte. Note, the remainder with sign occupies the rightmost byte of 
NUM1 and the quotient with sign occupies the remaining (leftmost) portion of NUM1. 





Example: 
LABEL AOPERATIONA OPERAND 
| 10 16 
DP NUM3 , NUM4& 
NUM3 DC PL4'646! 
NUM4 DC P'35' 
dividend 
leading zeros Packed 
NUM3 before execution decimal 
of DP instruction: po; ejorot ets] etc] — mmr 
divisor Packed 
NUM4 before and after T T decimal 
execution of DP instruction: Le ee ee ee number 
quotient remainder Two packed 


NUM3 after execution i decimal 
of DP instruction: pot Bic Font 6 iC numbers 


In this example, the packed decimal content of NUM3 is divided by the packed decimal 
content of NUM4. The result is placed in NUM3. The length of operand 1 is calculated by 
adding the actual number of bytes required to hold the data in NUM3 (2 bytes) and NUM4 
(2 bytes) which gives a total of four bytes for the dividend. In this example there also is a 
remainder of 16 that occupies the same number of bytes as the divisor and is located in 
the rightmost portion of operand 1. 
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ED 


9.6. EDIT (ED) 


General 
OBJECT 
OPCODE FORMAT | INST. 
TYPE LGTH. 


Condition Codes 





Possible Program Exceptions 


Ml AODRESS!ING Wi PROTECTION 

Hi DATA (INVALID SIGN/DIGIT) SIGNIFICANCE 

1 DECIMAL DiviDE SPECIFICATION: 

C) DECIMAL OVERFLOW NOT A FLOATING-POINT REGISTER 
0 execute OP 1 NOT ON HALF-WORD BOUNDARY 
(] EXPONENT OVERFLOW OP 2 NOT ON HALF-WORD BOUNDARY 
OC) EXPONENT UNDERFLOW OP 2 NOT ON FULL-WORD BOUNDARY 
C] FIXED-POINT DIVIDE OP 2 NOT ON DOUBLE-WORD 




































OOOOO00 




























Msettoo 

Mserto1 (J FIXED-POINT OVERFLOW BOUNDARY 

@ set 102 CO FLOATING-POINT DIVIDE QO OP 1 NOT EVEN NUMBERED REGISTER 

[]set to 3 C1 oPERATION L OP 1 NOT ODD NUMBERED REGISTER 
| 






SEE OPER. CONSIDERATIONS NONE 





The edit (ED) instruction unpacks and modifies packed operand 2 data so that the printed 
output received is printed the way you want it displayed. This modification is controlled by 
the operand 1 edit pattern. 


Explicit Format: 













A OPERATION A OPERAND 








[symbol] 





d, (I, .b, ),d, (b,) 


Implicit Format: 










OPERAND 





LABEL AOPERATION A 





[symbol] 


The contents of operand 2 must be a packed decimal number. Operand 1 contains the edit 
pattern which consists of EBCDIC character codes. It is the pattern of EBCDIC character 
codes you specify that determines how resuits are displayed. The edit pattern can 
rearrange, delete, select, or insert any needed data, symbols, or characters in the operand 
2 data. The edited result (unpacked and modified operand 2 data) replaces the operand 1 
edit pattern. 


Operational Considerations: 


= §=«The length of the operand 1 edit pattern is almost always longer than operand 2 
because operand 1 is in unpacked format while operand 2 is in packed format. 


= The edited result replaces operand 1, thus permanently destroying the edit pattern. If 
you intend to reuse the edit pattern, then it must be saved or moved prior to the 
execution of the ED instruction. 
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= The total number of significance starters and digit selectors in operand 1 must equal 
the total number of digits in operand 2. 


= if there is no significance starter in operand 1, all zeros in operand 2, and the fill 
character is hexadecimal 40, the resultant field is blank. 


= The condition code reflects only the last field edited or the field after the last field 
separator. 


# The S switch reflects the sign of the last byte in operand 2. A plus sign detected as 
the least significant digit turns the S switch off. A minus sign has no effect on the S 
switch, and a plus or minus sign detected as the most significant digit causes a data 
exception. 


= The sign of operand 2 is converted to hexadecimal F when edited, regardless of 
whether it is a hexadecimal C or F (positive), or a hexadecimal D (negative). 


9.6.1. The Edit Pattern 

The operand 1 edit pattern may consist of five types of pattern characters: 
2 = Fill character 

= §=© Digit selector 

a § Significance starter 

7 Message character 

m Field separator 


The fill character in all cases, is the leftmost byte of operand 1. It is any EBCDIC character 
code you choose. The EBCDIC character code specified is the first byte of the edited result, 
and replaces (or fills in) certain pattern characters corresponding to any nonsignificant 
operand 2 digits. (The significant digits are the digits 1 thru 9. Zero is the only 
nonsignificant digit but becomes significant when it follows a significant digit or the 
significance starter (hexadecimal 21)). The edited result replaces the operand 1 edit 
pattern. Some of the more commonly used fill characters are hexadecimal 40 (blank), 
hexadecimal 5B (dollar sign), and hexadecimal 5C (asterisk). 


The digit selector is the EBCDIC character code 20. For every digit in operand 2, there 
must be a corresponding hexadecimal 20 in the operand 1 edit pattern. Every significant 
digit in operand 2 replaces its corresponding digit selector in operand 1. If there is a 
nonsignificant digit in operand 2, the fill character replaces its corresponding digit selector. 
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@ Example: 
LABEL AOPERATIONA OPERAND 
| 10 16 
ED PATTERN] , ANSWER] 
PATTERNI DC X'49262626' 
ANSWERI DC P'253' 
fill 
PATTERN1 before execution eligieeaee digit ealemvor 





of ED instruction: 
Edit pattern 


ANSWER1 before and after 


execution of ED instruction: Packed decimal number 


Edited result 


PATTERN1 after execution of 


© ED instruction: 


Printed edit result looks 
like this: 


Printed output 


Note that in PATTERN1 there is a corresponding hexadecimal 20 for every digit in 
ANSWER1. The edit pattern (operand 1) is examined one byte at a time and operand 2 is 
examined one digit at a time. The fill character remains as the first byte of the edit result 
(operand 1), and the succeeding pattern characters (in this example, the digit selectors) are 
replaced by unpacked operand 2 digits. 


Example: 
ED PATTERN2 , ANSWER2 
PATTERN2 DC X'49292626' 
ANSWER2 DC P'26! 
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fill 
PATTERN2 before execution  “raracter Sigieselectors 
of ED instruction: 





Edit pattern 


ANSWER2 before and after 


execution of ED instruction: Packed decimal number 


PATTERN2 after execution 
of ED instruction: 


Edited result 


Printed output 
Printed edit result looks 


like this: 





In this example, note that ANSWER2 is padded to the left with a zero. Zero is considered a 
nonsignificant digit because it precedes any significant digits. Therefore, the fill character 
hexadecimal 40 replaces the second byte of the edit result, because zero corresponds to 
the first digit selector. The other packed operand 2 digits are unpacked and replace the 
remaining digit selectors. This method of changing lead zeros to blanks is called zero 
suppression. 





The significance starter is the EBCDIC character code 21. You need to specify only one 
hexadecimal 21 for each field to be edited. Every hexadecimal 21 must correspond to a 
digit in operand 2. When a hexadecimal 21 is examined in an edit pattern, it is replaced 
with its corresponding digit in operand 2 and then turns on the significance start switch (S 
switch). The significance start switch is an internal switch that when turned on forces all 
of the following pattern characters either to remain or be replaced in the edit result. In 
effect, the only conditions that force the S switch on are a hexadecimal 21 or a significant 
digit. On the other hand, the S switch is turned off after a digit in operand 2 is examined 
whose sign is positive and located in the rightmost four bit positions of a field. A negative 
sign does not affect the S switch. Whether the sign is positive or negative, all results are 
printed as positive values. 








Example: 
LABEL AQPERATIONA OPERAND 
1 10 16 
ED PATTERN3 , ANSWER3 
PATTERN3 DC X'4G2126202629' 


ANSWER3 DC PL3'248! 
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fill significance 
character starter digit selectors 


PATTERN3 before execution ~~. ~~. 
of ED instruction: 










Edit pattern 


ANSWERS before and after 


: ; . Packed decimal 
execution of ED instruction: 


PATTERNS after execution 
of ED instruction: 


Printed edit result looks 
like this: 


Printed output 


The fill character remains as the first byte of the edit result, and also replaces the 
significance starter because its corresponding digit in ANSWER3 is a nonsignificant zero. 
Now, the S switch is turned on and the second zero in ANSWER3 becomes significant. It 
replaces its corresponding digit selector with a zero. The succeeding operand 2 digits are 
unpacked and replace the remaining digit selectors. 


The message character can be any EBCDIC character code except hexadecimal 20, 21, or 
22. If the message character follows a significant digit or the significance start switch 
(hexadecimal 21), the message character remains as part of the edited result (operand 1). 
On the other hand, if the message character preceeds a significant digit or a hexadecimal 
21, it is replaced by the fill character. Some of the most commonly used message 
characters are hexadecimal 6B (comma) and hexadecimal 4B (decimal point). 





Example: 
LABEL AOPERATIONA OPERAND 
1 10 16 
ED PATTERN4 , ANSWER4S 
PATTERN4 DC X'SB262G6B2921264B262¢ ' 


ANSWER4 DC P'1326¢9' 
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PATTERN4 before execution 
of ED instruction: a aneede at - 
fill digit message digit significance digit message digit 
character selectors character selector starter selector character selector 
mn 





Edit pattern 





ANSWER4 before 
and after 
execution of 

ED instruction: 


Packed decimal number 


PATTERN4 after 
execution of ED 


instruction: Edited result 






Printed edit result looks 
like this: 


Printed output 


In this example, hexadecimal 5B (dollar sign) is used as the fill character. It remains as the 
first byte of the edited result and also replaces the second byte because the second byte’s 
digit selector corresponds to a nonsignificant zero. The digit 1 in ANSWER4 replaces the 
third byte and the message character hexadecimal 6B remains because it follows a 
significant digit. The digits 3, 2, and 6 in operand 2 replace their corresponding pattern 
characters, the message character hexadecimal 4B remains and the trailing zeros in 
ANSWER&4 replace their corresponding pattern characters. 


Note the position of the significance starter hexadecimal 21. In this example, the S switch 
is turned on by the first significant digit. Therefore, when this hexadecimal 21 is 
examined, it is replaced with its corresponding digit in ANSWER4. Now, suppose the edit 
pattern remains the same and operand 2 is changed to look like this example: 








Example: 
LABEL AOPERATIONA OPERAND 
1 10 16 
ED PATTERNS , ANSWERS 
PATTERNS DC X'5B26286B262 12848292¢' 


ANSWER5 DC PL4'75' 
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PATTERNS before execution 


of ED instruction: 
fill digit message digit significance digit message digit 
character faces character selector starter selector character selector 
es Veet 


mem ae eee 
f2tol«refatolato| 


Edit pattern 









ANSWERS before 
and after 
execution of 

ED instruction: 


Packed decimal number 


PATTERND after 
execution of ED 
instruction: 








Edited result 





Printed edit result looks 
like this: 


Printed output 


The significance starter (hexadecimal 21) is placed in the sixth byte of PATTERNS so that 
the S switch is turned on to force the display of bytes 7 through 10. As a result, the least 
significant dollar integer, the decimal point, and the cents are always represented no 
matter how small or large the value of operand 2 is. 


The field separator is the EBCDIC character code 22. It is used to separate two or more 
contiguous fields. These fields must be packed decimal numbers in operand 2 and located 
in consecutive order in main storage. The fill character you specify replaces all field 
separators. As soon as a hexadecimal 22 is examined, the S switch is turned off and the 
field separator is replaced with the fill character. 


Example: 
LABEL AOPERATIONA OPERAND 
1 10 16 
ED PATTERN6 , ANSWER6 
PATTERN6 DC X'492621262222262 1262222214B292G' 


ANSWER6 DC P'123COBBC2GBC ' 
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PATTERN6 before execution 
of ED instruction: 






finn digit significance digit field digit significance digit 
e 














Edit patter 


ANSWERE6 before 














and after } Cc Dy) fi c 2 q °o ae umber 
execution of 

ED instruction: 

PATTERN6 after [«| I LE T _| Sra ane 








execution of 
ED instruction: 





Printed edit result 
looks like this: 


an / PP 


inted output 








In this example, ANSWER6G contains three packed contiguous fields each separated by two 
field separators (hexadecimal 22). Since the fill character specified is hexadecimal 40, that 
character is used as the fill character for all fields, and also replaces each field separator 
in the edit pattern. Remember that the S switch is turned off as soon as a hexadecimal 22 
is examined. This causes any leading zeros in succeeding fields to be nonsignificant. digits. 


9.6.2. The Resulting Condition Code 


All operand 2 digits examined are tested for condition code O. The sign of the last packed 
field edited, and whether or not all the digits in that field are zeros, are recorded in the 
condition code setting when execution of the ED instruction is completed. 


The 


The 


condition code is set to O when: 
all digits in the last field edited in operand 2 are zeros; 


the edit pattern has no digit selectors or significance starters causing operand 2 digits 
not to be examined; 


the last character in the edit pattern is a field separator; and 


the edit pattern has no digit selectors or significance starters after the last field 
separator. 


condition code is set to 1 when: 
the last field edited is not all zeros but the S switch is on. This indicates the value of 


the last field edited is less than zero, because a negative sign does not affect the S 
switch. 


























UP-8061 Rev. 3 SPERRY UNIVAC OS/3 9—23 
ASSEMBLER 


The condition code is set to 2 when: 


= the last field edited is not all zeros but the S switch is off. This indicates the value of 
the last field edited is greater than zero, because a positive sign turns the S switch 
off. 


9.6.3. Examples of General Usage 


The following examples are more commonly used and can be applied in practical 
situations. The first example shows how a nonblank fill character is used. 


Example: 


LABEL . AOPERATIONA OPERAND 
] 10 16 


ED PATTERN? , ANSWER7 


PATTERN7 OC X 52929282020" 
ANSWER] DE 12345! 


PATTERN7 before fill 

execution of ED character digit selectors 
instruction: 
Edit 
pattern 
ANSWER7 before and 
after execution of 

ED instruction: 


PATTERN? after 
execution of ED 
instruction: 


Packed 
decimal 
number 


Edited 
result 


Printed edit result 
looks like this: 


Printer 
output 





All results, whether positive or negative, are printed as positive results. By using message 
characters in the edit pattern, you can indicate whether a field in operand 2 is positive or 
negative. These message characters should be the last pattern characters in the edit 
pattern for each corresponding field in operand 2. If the value of operand 2 is negative, 
message characters placed to-the right of the rightmost digit selector remain as part of the 
edit result. Since a negative sign in the rightmost four bit positions does not affect the S 
switch, the message characters become significant. However, if the value of operand 2 is 
positive, the message characters are replaced by the fill character. 
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Since a positive sign in the rightmost four bit positions turns the S switch off, the 
message characters become nonsignificant. You can specify any character or any number 
of characters to indicate a negative number, but the most commonly used are hexadecimal! 
C3D9 (CR), hexadecimal C3C2 (DB), and hexadecimal 60 (—). The following example 
illustrates editing a negative number using the minus sign. 


Example: 


LABEL AOPERATIONA OPERAND 
| 10 16 








ED PATTERNS , ANSWERS 
PATTERNS DC X'49292028202960" 
ANSWERS OC P'-1234! 


PATTERNY before fill ccnee 
execution of ED character digit selectors character 





instruction: Edit 


pattern 


ANSWERS before 
and after execution 
of ED instruction: 





Packed 
decimal 
number 
PATTERN after 
execution of ED 


instruction: 


Edited 
result 


Printed edit result 


looks like this: Printed 


output 


The following example illustrates date-field editing. Here, message characters are inserted 
into a five- or seven-digit field. The most commonly used message characters for a date 
field are hexadecimal 61 (slash), hexadecimal 60 (hyphen), and hexadecimal 40 (blank). 


Example: 


ED PATTERNA , ANSWERA 


PATTERNA DC X ‘492 129612620612026' 
ANSWERA DC P'122576! 
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® PATTERNA before ——cnsracter tector marer ae Wace. re saan ee 
execution of ED : : 


instruction: 


Edit pattern 








ANSWERA before and 
after execution of ED 


instruction: 


Printed edit result looks 
like this: 


Packed decimal 
number 


PATTERNA after 
execution of ED 
instruction: 
















Edited 
result 


Printed 
output 


9.6.4. Summary 





Table 9—1 summarizes and combines the information in this section to provide a clear 
and concise picture of the ED instruction and its functions. 


Table 9—1. Edit Instruction Operation 


Previous Decimal Sign of Least Resulting Resulting 
Pattern (Operand 1) EBCDIC Switch (Operand 2) Significant Byte (Operand 1) Switeh 
Character Code Status Digit (Operand 2) Character Status 
a a 
Digit selector Fill character 
© Digit 
Positive Digit 
Negative Digit 
* Digit 
* Digit 
Positive Digit 
Negative Digit 
Significance starter Fill character 
Digit 
Digit 
Digit 
Message character Any except Not examined * Fill character’ 
20,21,22 Not examined Positive Fill character 
Not examined ? Message character 
Not examined Positive Fill character 
Not examined Negative Message character 
& Field separator Not examined Fill character 
Not examined : Fill character 





*Not applicable 
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MVC 


9.7. MOVE CHARACTER (MVC) 


Possible Program Exceptions 












OPCODE ae Mi ADDRESSING @ PROTECTION 
pe eal pee, C0 DATA (INVALID SIGN/DIGIT)| [] SIGNIFICANCE 
| Mem. |HEx.| (Bytes) || ) DECIMAL DivIDE ( SPECIFICATION: 


NOT A FLOATING-POINT REGISTER 

OP 1 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON FULL-WORD BOUNDARY 


OP 2 NOT ON DOUBLE-WORD 
BOUNDARY 
oP 1 NOT EVEN NUMBERED REGISTER 


OP 1 NOT ODD NUMBERED REGISTER 


0 DECIMAL OVERFLOW 

O] execute 

0 EXPONENT OVERFLOW 
(EXPONENT UNDOERFLOW 
DD FIXED-POINT DIVIDE 

OD FIXED-POINT OVERFLOW 
C] FLOATING-POINT DIVIDE 
C] OPERATION 


Condition Codes 


CIF RESULT = 0, SET TOO 
Cir RESULT <0, SET TO 1 
OJtF RESULT >0, SET TO 2 
CIF OVERFLOW, SET TO 3 
BB UNCHANGED 






Oo 
O 
O 
0 
O 
O 
ie) 
O 


NONE 






The move character (MVC) instruction moves the contents of one area in main storage 
(operand 2) into another area in main storage (operand 1). The length of operand 1 
determines the number of bytes moved. 


Explicit Format: 






A OPERATION A OPERAND 





[symbol] d, (I,b, ),d, (b,) 


Implicit Format: 





OPE RAND 





A OPERATION A 





[symbol] S, (I),s, 


The move character instruction moves data referenced by operand 2 (the sending field) to 
the location referenced by operand 1 (the receiving field). Data is moved a byte at a time 
from left to right. The length of operand 1 whether implied or explicit determines the 
number of bytes to be moved. 


Operational Considerations: 


= The instruction moves one byte at a time, processing from left to right through each 
field. 


= The length of operand 1 determines the number of bytes moved. It can be either 
implied or explicit. 


= When using operands with overlapping bytes, the results are often unpredictable. 











@ 
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= One character can be propagated through an entire field if the sending field begins 
with the first byte of a field and the receiving field begins with the second byte of that 
same field. 


= Any type of data can be specified in an MVC instruction. 





Example: 
LABEL  AOPERATIONA OPERAND 
1 10 16 
MVC RECEIVET,SENDI 
RECEIVE] DC CL5'DIGIT! 
SEND] OC CL5'SALES' 


RECEIVE1 before 
execution of MVC 
instruction: 


Alpha characters 


Hexadecimal 
(EBCDIC mode) 





SEND1 before and after 
execution of MVC 
instruction: 


Alpha characters 


Hexadecimal 
(EBCDIC mode) 


RECEIVE1 after 
execution of MVC 
instruction: 


Alpha characters 


Hexadecimal 
(EBCDIC mode) 





In this example, the content of operand 2 is moved into operand 1. Since it is an even 
move (a 5-byte field to a 5-byte field), the content of SEND1 completely overlays the 
content of RECEIVE1. Note that no length is specified for operand 1 and, as a result, the 
implied length is applied. 


Example: 


MVC RECE!VE2 (5) ,SEND2 


RECEIVE2 DC CL7' JANUARY! 
SEND2 pc CL5'MARCH' 
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RECEIVE2 before 
execution of MVC 
instruction: 


Alpha characters 


Hexadecimal 
(EBCDIC mode) 





SEND2 before and after 
execution of MVC 
instruction: 


Alpha characters 







Hexadecimal 
(EBCDIC mode) 


leftover 
operand 1 
data 





RECEIVE2 after Alpha characters 
execution of MVC 


instruction: 


Hexadecimal 
(EBCDIC mode) 


In the preceding example, an explicit length of 5 is specified for operand 1. The 5 
determines that RECEIVE2 will accept only five bytes from SEND2. The five bytes from 
SEND2 are moved to RECEIVE2 filling operand 1 from left to right. As you can see, five 
bytes of SEND2 (MARCH) are moved to the first five bytes of RECEIVE2 (JANUA). Note that 
the last two bytes of RECEIVE2 still remain. 





Example: 
LABEL AOPERATIONA OPERAND 
| 10 16 
MVC TOTAL (2) , ANSWER+1 
TOTAL Dc PL4'g! 
ANSWER DC PL3'128! 
HEADING DC CLI9'TOTAL SALES FOR MAY' 
TOTAL before execution fotofotoloto| sare Packed decay 
of MVC instruction: number 
ANSWER + 1 
™ 


ANSWER before and after 


. : t Packed decimal 
execution of MVC instruction: 


number 





operand 1 
data 


TOTAL after execution Two pace 
of MVC instruction: ee Cee ee a a 


Since the concerned number occupies the second and third bytes of ANSWER, relative 

addressing (ANSWER + 1) is used to address the second byte, and avoid the first byte of 

zeros. Note the number of bytes moved is restricted to two by using an explicit length in 

operand 1. If an explicit length is not specified, four bytes would be moved to TOTAL since & 
it is a 4-byte field. Bytes two and three of operand 2, plus the first two bytes of data 

contiguous to operand 2 (in this case the letters TO of HEADING), would be moved to 

TOTAL. 
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€ Example: 
LABEL AOPERATIONA OPERAND 
] 10 16 
MVC FIELD+1 (3) ,FIELD 
FIELD DC CL4'1234! 
FIELD before execution Hexadecimal 
of MVC instruction: (EBCDIC mode) 
FIELD after byte 1 is F 
d: Hexadecimal 
moved: (EBCDIC mode) 
FIELD after byte 2 is Hexadecimal 
& moved: (EBCDIC mode) 
FIELD after byte 3 is Hexadecimal 
(EBCDIC mode) 


moved: 





final result 


As indicated, Fi is propagated through the entire field. This can be done using any 
character. If a hexadecimal 40 is used, the resultant field is EBCDIC blanks. If a 
hexadecimal FO is used, the resultant field is EBCDIC zeros. To propagate one character 
through an entire field, the sending field (operand 2) must begin with the first byte of that 
field and the receiving field (operand 1) must begin with the second byte of that same 
field. The move is processed from left to right. When operands 1 and 2 overlap, the end 
result is obtained by processing the operands one byte at a time, and putting each result 
byte immediately after the byte just obtained. 
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9.8. MOVE NUMERICS (MVN) 


OBJECT 
OPCODE FORMAT | INST. 
TYPE LGTH. 


Possible Program Exceptions 


Hi ADORESSING BB PROTECTION 

(J DATA (INVALID SIGN/DIGIT) [LD SIGNIFICANCE 

(J DECIMAL DIVIDE (J SPECIFICATION: 

CO DECIMAL OVERFLOW NOT A FLOATING-POINT REGISTER 

OJ Execute OP 1 NOT ON HALF-WORD BOUNDARY 
DC EXPONENT OVERFLOW OP 2 NOT ON HALF-WORD BOUNDARY 
C] EXPONENT UNDERFLOW OP 2 NOT ON FULL-WORD BOUNDARY 
DD FIXED-POINT DIVIDE OP 2 NOT ON DOUBLE-WORD 


O FIXED-POINT OVERFLOW BOUNDARY 
[] FLOATING-POINT DIVIDE OP 1 NOT EVEN NUMBERED REGISTER 


C] OPERATION OP 1 NOT ODD NUMBERED REGISTER 
NONE 
























| MNEM. | HEX. (BYTES) 


Condition Codes 


Oj1F RESULT = 0,SET TOO 





















Or RESULT <o, SET TO1 
Cie RESULT > 0, SET TO 2 
CIF OVERFLOW, SET TO 3 
BB UNCHANGED 










OOO OoOo0O0 







The move numerics (MVN) instruction moves the low order four bits (digit portion) of each 
byte in operand 2 into the corresponding low order four bits of each byte in operand 1. The 
high order four bits (zone portion) of each byte in operand 1 remain unchanged. This 
instruction operates from left to right. 


Explicit Format: 









A OPERATION A OPERAND 





[symbol] d, (1,b, ),d, (b,) 
Implicit Format: 


LABEL A OPERATION A OPERAND 





[symbol] | MVN 


Operational Considerations: 
= ~=6Any type of data can be specified in both operands 1 and 2. 
= The condition code remains unchanged. 


. The high order bit positions of each byte in operand 1 remain unchanged. 
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& Example: 
LABEL AOPERATIONA OPERAND 
1 10 16 
MVN TOTAL1+2(3) ,SUBTOT] 
TOTAL] DC 2L5'12123! 
SUBTOTI] DC ZL3'345' 
TOTAL1+2 ee 














execution of MVN hexadecimal 

instruction: sae (EBCDIC mode) 

SUBTOT1 before and Binary 

after execution of ica, a 
. . mor 

MVN instruction: e 

execution of MVN hexadecimal 


In this example, the low order four bit positions of each byte in SUBTOT1 are moved into 
the low order four bit positions of bytes 3, 4, and 5 of TOTAL1. The high order bit positions 
of each byte in TOTAL1 remain unchanged. 


Example: 
1: AP RESULT ,=P '5@! 
2. MVN RESULT+2 (1) ,RESULT+3 
MVC BUFFER, SPACES 

3. | MVC _ BUFFER(3) ,RESULT 
RESULT DC PL4'1234567' 
BUFFER DS CLS 
SPACES _ DC cis! * 


UP-8061 Rev. 3 


RESULT before execution 
of AP instruction: 


Operand 2 before and after 


execution of AP instruction: 


RESULT after execution 
of AP instruction: 


RESULT before execution 
of MVN instruction: 


RESULT after execution 
of MVN instruction: 


In this example, the MVN instruction is used in rounding numbers. In the first line of code, 
the literal fifty (50) is added to the contents of RESULT to round the number to the first 


two decimal places. 


Then, the low order four bits of byte 4 in RESULT are moved to the low order four bits of 
byte 3 in RESULT. When the MVN instruction is completed, the sign is moved to the right 
of the first two decimal places that were just rounded. The last byte of RESULT is ignored 
when the MVC instruction is executed. The location named BUFFER contains the final 


result. 
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blanks 








Packed decimal number 


Packed decimal literal 


Packed decimal number 


Packed decimal number 


Packed decimal number 











BUFFER before execution edad 
of MVC instruction:  [4#!o]«to]sto ls to] «to | team 


BUFFER after execution 
eMC insficion teu soe ee esata: 


Packed decimal 
number 
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9.9. MOVE WITH OFFSET (MVO) 


OBJECT || gy ADDRESSING WI PROTECTION 


OPCODE | FORMAT | INST. 
| 
eae ene: (0 DATA (INVALID SIGN/DIGIT)| [] SIGNIFICANCE 


MNEM. (BYTES) || LJ) DECIMAL DiviDE DD sPECIFICATION: 
C1 DECIMAL OVERFLOW NOT A FLOATING-POINT REGISTER 
}mvo |rr{ ss | 6 | C] execute OP 1 NOT ON HALF-WORD BOUNDARY 


(J EXPONENT OVERFLOW OP 2 NOT ON HALF-WORD BOUNDARY 
Condition Codes C0 EXPONENT UNDERFLOW OP 2 NOT ON FULL-WORD BOUNDARY 


Clit RESULT-0.SETTOO CO FIXED-POINT DIVIDE OP 2 NOT ON DOUBLE-WORD 

Clit RESULT <0, SET TO 1 OC FIxe€D-POINT OVERFLOW BOUNDARY 

Cie RESULT >O. SET TO 2 (J FLOATING-POINT DIVIDE OP 1 NOT EVEN NUMBERED REGISTER 
CIF OVERFLOW, SET TO 3 (1 OPERATION OP 1 NOT ODD NUMBERED REGISTER 
BB UNCHANGED NONE 





The move with offset (MVO) instruction moves the contents of operand 2 into operand 1 
offsetting the data one half-byte to the left during the move. 


Explicit Format: 









A OPERATION A 





LABEL OPERAND 


[symbol] d, (I, -b, ),d, (I,,b,) 


implicit Format: 





A OPERATION A OPERAND 


[symbol] s, (I, ),S2 (I) 


The MVO instruction operates from right to left. Data from operand 2 (the sending field) is 
moved into operand 1 (the receiving field) but offset one half-byte to the left. The low order 
four bits of the rightmost byte in the receiving field remain unchanged. If operand 2 data 
does not completely fill operand 1, the leftmost unfilled bytes of operand 1 are padded 
with zeros. However, if the operand 2 field is larger than the operand 1 field, the leftmost 
bytes of operand 2 are truncated. The MVO instruction is most commonly used in 
rounding packed decimal numbers to an odd number of digits. 


Operational Considerations: 


a Usually, the MVO instruction operates on packed decimal fields; however, unpacked 
fields can be specified. 
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= Padding of zeros to the left and truncation to the left can occur. 





® Condition code remains unchanged. 


























Example: 

LABEL AOPERATIONA OPERAND 
1 10 16 

MVO FIELD! ,FIELD2 
FIELD] Cc XL4'FFEFFFFF! 
FIELD2 oc XL3 'AABBCC! 
FIELD1 before execution a444i4404 1499) 149911194 1911 Binary 

: : | 
of MVO instruction: eave aves] savant any taey hexadecimal 
FIELD2 before and after | 1010 1010 1011 ; 1011 [1100 {1100 | Binary 
execution of MVO instruction: 1 hexadecimal 
; 0000 | 1010 1011, 1100/1100! 1411 Bi 

FIELD1 after execution poet jasgo fw [ ts] ainey 





characters 


of MVO instruction: 


See 


In this example, the content of FIELD2 is moved (starting from right to left) into FIELD1 
offset by one half-byte to the left. The low order four bits of the rightmost byte of FIELD1 
(1111, or hexadecimal F) remain unchanged. 





Each half-byte of FIELD2 fills its corresponding half-byte of FIELD1. The high order four 
bits of the leftmost byte of FIELD1 are padded with binary zeros since the operand 1 field 
is larger than operand 2. 


Example: 


MVO PRICE ,PRICE (2) 


PRICE DC 137254! 
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operand 1 
oO _ 


operand 2 


PRICE before execution 
of MVO instruction: 


Packed decimal number 


assumed decimal point 


PRICE after execution 
of MVO instruction: 





In this example, the MVO instruction is used in rounding packed decimal numbers. An 
explicit length is specified for operand 2 and both operands have overlapping bytes. If all 
‘decimal places are needed in the final result, then this rounding technique is not useful. 
The purpose of this MVO instruction is to move the final result (dollars and cents) next to 
. the sign so that it can be edited and printed. Note the decimal number 4 in the high order 
‘four bits of the rightmost byte of operand 1 is replaced with the decimal number 5 and 
binary zeros are padded in the high order four bits of the leftmost byte of operand 1. 
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MvZ 
9.10. MOVE ZONES (MVZ) 


Possible Program Exceptions 


OBJECT |) gy ADDRESSING MB PROTECTION 


OPCODE FORMAT | INST 
; TA (INVALID SIGN/DIGIT) SIGNIFICANCE 
TYPE LGTH. Cj DATA | O 


| nem, |HEX. | (eyTes) || (J) DECIMAL DIVIDE C0 SPECIFICATION: 
OC DECIMAL OVERFLOW 


NOT A FLOATING-POINT REGISTER 

OP 1 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON FULL-WORD BOUNDARY 


OP 2 NOT ON DOUBLE-WORD 
BOUNDARY 


OP 1 NOT EVEN NUMBERED REGISTER 
OP 1 NOT ODO NUMBERED REGISTER 


(C EXPONENT OVERFLOW 
OO EXPONENT UNDERFLOW 
OF RESULT = 0, SET TOO CJ FIXED-POINT DIVIDE 
Cir RESULT <0, SETTO1 OC) FIxED-POINT OVERFLOW 
Clie RESULT >0O, SET TO 2 CJ FLOATING-POINT DIVIDE 


DIF OVERFLOW, SET TO 3 (J OPERATION 
BB UNCHANGED 


O0DOO OOoO00 


ral 
fe) 
2 
m 





The move zones (MVZ) instruction moves the high order four bits (zone portion) of each 
byte in operand 2 into the corresponding high order four bits of each byte in operand 1. 


Explicit Format: 


LABEL A OPERATION A ; OPERAND 


[symbol] d, (I,b, ),d, (b,) 





Implicit Format: 





OPERAND 






A OPERATION A 





[symbol] 


This instruction operates from left to right. The low order four bits of each byte in operand 
1 remain unchanged. If the operand 2 field is larger than operand 1, the zone portions of 
the leftmost bytes of operand 2 are truncated. On the other hand, if the operand 1 field is 
larger than operand 2, the zone portions of the leftmost bytes in operand 1 remain 
unchanged. 


Operational Considerations: 


= The contents of both operands should contain zoned numeric fields; however, any 
type of data can be specified. 


= = The low order four bits of each byte in operand 1 remain unchanged. 


7 Operands 1 and 2 can have overlapping bytes. 
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@ = The condition code remains unchanged. 
Example: 
LABEL AOPERATIONA OPERAND 
1 10 16 
MVZ NUMPOS , NUMNEG 
NUMPOS DC ZL3'456! 
NUMNEG DC XL3'FOF ODD! 


Binary zoned 
decimal number 
(positive) 


NUMPOS before execution 
of MVZ instruction: 


Binary zoned 
decimal number 
(negative) 


NUMNEG before and after 
execution of MVZ instruction: 


Binary zoned 
decimal number 
(negative) 


NUMPOS after execution 
of MVZ instruction: 





In this example, the zone portions of each byte in NUMNEG are moved into the 
corresponding zone portions of each byte in NUMPOS. As a result, the sign is changed 
from positive to negative by moving a hexadecimal D into the high order four bits of the 
rightmost byte of NUMPOS. The other two zone portions are replaced with the same 
hexadecimal value. 
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MP 


9.11. MULTIPLY DECIMAL (MP) 


General 


OBJECT 
OPCODE FORMAT | INST. 


; Possible Program Exceptions 


@ A°CDRESSING @ PROTECTION 

Wl DATA (INVALID SIGN/DIGIT) | [] SIGNIFICANCE 

(1 DECIMAL DIVIDE Wl SPECIFICATION: 

OC DECIMAL OVERFLOW NOT A FLOATING-POINT REGISTER 

(] Execute OP 1 NOT ON HALF-WORD BOUNDARY 
0 EXPONENT OVERFLOW OP 2 NOT ON HALF-WORD BOUNDARY 
() ExPONENT UNDERFLOW OP 2 NOT ON FULL-WORD BOUNDARY 
(1D FIXED-POINT DIVIDE OP 2 NOT ON DOUBLE-WORD 


OJ FIX€D-POINT OVERFLOW BOUNDARY 
C] FLOATING-POINT DIVIDE OP 1 NOT EVEN NUMBERED REGISTER 


C oPERATION OP 1 NOT ODD NUMBERED REGISTER 
: NONE 












TYPE LGTH. 


Condition Codes 


CJ 1F RESULT = 0, SET TOO 
Oli RESULT <0, SETTO1 
Cre RESULT > 0, SET TO 2 
CIIF OVERFLOW, SET TO 3 
GUNCHANGED 























OOO OoOo00 










The multiply decimal (MP) instruction algebraically multiplies the packed decimal contents 
of operand 2 (multiplicand) by the packed decimal contents of operand 1 (multiplier) and 
stores the result (product) in operand 1. The receiving field (operand 1) is filled from right 
to left. 


Explicit Format: 





OPERAND 






A OPERATION A 





[symbol] d,(1,,b, ),d, (I, ,b,) 





Implicit Format: 





A OPERATION A OPERAND 






[symbol] s,(I,),s, (15) 





Because the result replaces operand 1, you must ensure that the operand 1 field is large 
enough to hold the product. This is determined by adding the number of bytes required to 
hold the multiplicand to the number of bytes required to hold the multiplier. 


length of "+ — length of = length of 
multiplicand multiplier operand 1 (product) 


If you use this rule, the multiplicand will have at least as many high order zeros as the 
number of digits in the multiplier. These high order zeros prevent overflow from occurring 
in the final result. 


The multiplier (operand 2) can be up to 8 bytes long which can consist of 15 digits and a 
sign. The resultant product (operand 1) can be up to 16 bytes long which can consist of 31 
digits and a sign. 
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& Example: 
LABEL  AOPERATIONA OPERAND 
1 10 16 
MP HOURS , RATE 
HOURS DC PLA ‘kg! 
RATE DC PL2'Sgp! pa 


HOURS before execution 


RATE before and after eee 

execution of MP instruction: a > - Packed decimal number 
z assumed decimal point 

of MP instruction: 


Pr assumed decimal point 


In this example, the length of operand 1 is determined by adding the number of bytes 
required to hold the packed decimal 40 (2 bytes) to the number of bytes required to hold 
the packed decimal! 500 (2 bytes) which gives the total of 4 bytes. Then the multiplication 
operation takes place operating from right to left. The product replaces HOURS and the 
sign is determined algebraically. (In this example, positive x positive = positive.) 
Operational Considerations: 

a The operand 1 field must be large enough to hold the product. 


= ~=6©The operand 2 field is limited to 8 bytes in length and the operand 1 field is limited to 
16 bytes in length. 


= Since a symbolic name references the leftmost or high order portion of a location in 
main storage, overlapping bytes can exist in the rightmost bytes only. 


If overlapping bytes exist in the leftmost portion, the number of bytes required to hold the 
multiplicand and the multiplier will be larger than the receiving field. 


ws The condition code remains unchanged. 


= Multiplication by powers of 10 adds decimal places to a specified value. 
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PACK 


9.12. PACK DECIMAL (PACK) 


Possible Program Exceptions 















FORMAT pores i ADDRESSING WB PROTECTION 

TYPE cere: (J PATA (INVALID SIGN/DIGIT) | [) SIGNIFICANCE 

(eyes) || CL) DECIMAL DIVIDE CO sPEcIFICATION: 

0 DECIMAL OVERFLOW NOT A FLOATING-POINT REGISTER 
OJ execute 


OP 1 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON FULL-WORD BOUNDARY 
OP 2 NOT ON DOUBLE-WORD 


Condition Codes 





(J EXPONENT OVERFLOW 
DD EXPONENT UNDERFLOW 
D0 FIXED-POINT DIVIDE 





Dir RESULT = 0,SET TOO 


Cir RESULT <o, SETTO1 
Cif RESULT > 0, SET TO 2 
CIF OVERFLOW, SET TO 3 


(0 F1xX€D-POINT OVERFLOW 
OD FLOATING-POINT DIVIDE 
(0 OPERATION 


BOUNDARY 
OP 1 NOT EVEN NUMBERED REGISTER 
OP 1 NOT ODD NUMBERED REGISTER 


NONE 


HE UNCHANGED 





The pack decimal (PACK) instruction converts data in operand 2 from unpacked format to 
packed format. (See 9.1.) The result replaces operand 1. 


Explicit Format: 





OPERAND 





A OPERATION A 





[symbol] d, (I,, b,), d, (lz, b,) 


Implicit Format: 






A OPERATION A OPERAND 





[symbol ] s, (l,), sy (I) 

Any data that is to be used in decimal arithmetic must be stored in packed decimal format 
before any arithmetic operations are performed. After your calculations are processed, 
packed data must be changed back to unpacked (zoned decimal) format to be sent to the 
printer or any other character sensitive device. Remember, when data is input from an 
external device (i.e., card reader), the data is stored in zoned decimal format. Operand 2, 
the sending field, is defined as a character type or zoned type field. Operand 1, the 
receiving field, is defined as a packed field and should contain enough bytes to receive all 
digits (plus the sign) from operand 2. 


The formula for computing the number of bytes required to receive unpacked operand 2 
data is: 


number of bytes required for 
packed operand 1 field (round 


(Number of bytes of operand 2) +1 _ 
ea ema Sil nnRRReRR ERE 
upward to the nearest byte) 

















UP-8061 Rev. 3 SPERRY UNIVAC 0S/3 9-41 


ASSEMBLER 





When the PACK instruction is executed, all zones in operand 2 are ignored except the 
zone in the rightmost byte. That zone portion (the sign) and the digit portion are reversed 
and placed in the rightmost byte of operand 1. Each digit in operand 2 is placed in operand 
1 next to the rightmost byte, filling in from right to left. Any unfilled bytes of half-bytes 
that are part of the specified length for operand 1 are zero-filled. Any unfilled bytes that 
are not part of the specified length for operand 1 remain unchanged. 


Operational Considerations: 





=  Operand 2 data should be in zoned decimal format. 
= Operand 1 should contain enough bytes to receive all digits (plus the sign) from 
operand 2. 
= ~=6 This instruction operates from right to left. 
# #8@Any unfilled bytes or half-bytes that are part of the specified length for operand 1 are 
zero-filled. 
= §©Any unfilled bytes that are not part of the specified length for operand 1 remain the 
same. 
= Specification of a length attribute for operands 1 and 2 is optional. 
= =§=The condition code remains unchanged. 
Example: 
LABEL AOPERATIONA OPERAND 
| 10 16 
PACK AMTP (3) , AMT (4) 
AMT DC ZL4'1234' 
AMTP DC PL3'O' 


AMTP before execution 
of PACK instruction: 


for ol oro | o14c Packed decimal number 

AMT before and after ee e 
i oned o 
execution of PACK Pert elope ts | ea ed or unpacke 


: : decimal number 
instruction: 


AMTP after execution zero o11 213 4itc Packed decimal number 
of PACK instruction: 
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in this example, the content of AMT (a 4-byte zoned decimal number) is packed into AMTP 
(a 3-byte packed field of zeros). The sign and digit portions of the rightmost byte of AMT 
are reversed and placed in the rightmost byte of AMTP. Then the next digit (3) is placed 
next to the left of the rightmost byte. Then digit 2 is placed to the left of digit 3 and digit 1 
is placed to the left of digit 2. The high order four bits of the leftmost byte are zero filled. 
As you can see in this example, two decimal digits occupy a single byte with the exception 
of the rightmost (sign) byte. Note that a length attribute is specified for both operands in 
the examples. The length attribute can be omitted but it is suggested it be included for 
clarity. 





Example: 
LABEL AOPERATIONA OPERAND 
1 10 16 
PACK AMOUNTIN+1(2) ,AMOUNTIN (3) 
AMOUNTIN DC C'768! 
AMOUNTIN+1 


AMOUNTIN before execution 
of PACK instruction: 


Zoned decimal number 


Zoned decimal number 


AMOUNTIN during execution 
of PACK instruction: 


Zoned decimal number 





AMOUNTIN after execution Bop ee |) eee e. | Pateeonet end pat 
of PACK instruction: packed decimal number 


This example shows that the content of AMOUNTIN (a 3-byte zoned decimal field) is 
packed into part of itself (AMOUNTIN+1, a 2-byte zoned decimal field). The zone portion (F) 
and digit portion (8) of the rightmost byte of AMOUNTIN are reversed and placed in the 
rightmost byte of AMOUNTIN+1. The digits 6 and 7 are placed to the left of the rightmost 
byte, 6 in the low order four bits and 7 in the high order four bits. Because the leftmost 
byte of AMOUNTIN is not part of the resultant field, that byte remains unchanged. Since 
AMOUNTIN is now a part zoned, part packed field, you should move the packed decimal 
number to another field before performing any mathematical calculations. Note that 


packing a number into itself is not considered good practice since results are often 
unpredictable. 
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& Example: 


LABEL 
] 


INVAMT 


INVAMT before execution 
of PACK instruction: 


INVAMT during 
execution of 
PACK instruction: 
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AOPERATIONA OPERAND 
10 16 
PACK INVAMT (5) , INVAMT (5) 
oc ZL5'-52866' 


Zoned decimal 
number 





INVAMT after execution 


of PACK instruction: number 


The content of INVAMT (a 5-byte zoned field) is packed into itself. The zone portion (D) and 
the digit portion (0) of the rightmost byte are reversed and returned to the same byte. The 
remaining zones are ignored. The remaining digits are placed in INVAMT starting next to 
the rightmost byte and filling each half-byte from right to left. Because the full length of 
operand 1 is specified, the remaining unfilled bytes are zero-filled. 
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SP 


9.13. SUBTRACT DECIMAL (SP) 


Possible Program Exceptions 


BB ADDRESSING W PROTECTION 






OBJECT 
















OPCODE 
paar eke DATA (INVALID SIGN/DIGIT)| [] SIGNIFICANCE 
(BYTES) || DJ) DECIMAL DIVIDE (1) sPeciFIcATION: 


@ pecimat OVERFLOW NOT A FLOATING-POINT REGISTER 
OO Execute OP 1 NOT ON HALF-WORD BOUNDARY 


Condition Codes 


Wir RESULT =0,SET TOO 
Mir Resuct <o,setto1 
Wir RESULT >0, SET TO2 
Bif OVERFLOW, SET TO3 
LJ UNCHANGED 









(1 EXPONENT OVERFLOW OP 2 NOT ON HALF-WORD BOUNDARY 
OC) EXPONENT UNDERFLOW OP 2 NOT ON FULL-WORD BOUNDARY 
OC FIXED-POINT DIVIDE OP 2 NOT ON DOUBLE-WORD 


(CO FIXED-POINT OVERFLOW BOUNDARY 
CO] FLOATING-POINT DIVIDE OP 1 NOT EVEN NUMBERED REGISTER 


C oPperRATION OP 1 NOT ODD NUMBERED REGISTER 
NONE 





The subtract decimal (SP) instruction algebraically subtracts the packed decimal contents 
of operand 2 from the packed decimal contents of operand 1 and stores the result in 
operand 1. 


Explicit Format: 






A OPERATION A OPERAND 





[symbol] d, (I, ,b,),d, (I, -b,) 


Implicit Format: 






A OPERATION A OPERAND 


[symbol] 





s,(I,).59 (Ip) 


Operand 1 (minuend) and operand 2 (subtrahend) must be in packed decimal format. The 
operand 1 field should be equal and in most cases larger than the size of operand 2. If 
operand 1 is too short to contain the result (difference), an overflow condition occurs. 
Subtraction is algebraic, concerning the signs and digits of both operands. If the sign of 
operand 2 is negative, it is treated as positive; if positive, it is treated as negative. Then, 
both operands are added together and the result is placed in operand 1. The sign of the 
difference is determined by the rules of algebra. If the result is ismaller than the operand 
1 field, any unfilled leftmost bytes are zero filled. On the other hand, if the result is larger 
than the operand 1 field, the leftmost bytes of the result are truncated. 


Operational Considerations: 


= Operands 1 and 2 must be in packed decimal format. 
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= The length of operand 1 should be equal to or larger than the length of operand 2. 


= Subtraction is algebraic. 





Example: 
LABEL AOPERATIONA OPERAND 
1 10 16 
SP GROSS (3) ,DEDUCT(3) 
GROSS Dc P'29666' 
DEDUCT pc P'6g27' 
GROSS before execution | Packed decimal number 
of SP instruction: 2,0 o;,¢ (assumed decimal point) 


DEDUCT before and after fote|o!2| 7!'!¢ Packed decimal number 
execution of SP instruction: (assumed decimal point) 
GROSS after execution es 9 7 3 'c¢ Packed decimal number 


of SP instruction: ! (assumed decimal point) 


In this example, the content of DEDUCT is subtracted from the content of GROSS. The 
result replaces GROSS and, in this example, completely fills the operand 1 field. The signs 
of both operands are positive which produces a positive result. 


Example: 
SP FIELD, FIELD+2 (2) 
FIELD DC P'6249311' 
operand 1 
Fae i ee 
FIELD before execution feu |) ate | 341 11.C Packed decimal number 
of SP instruction: 
operand 2 
(assumed decimal point) 
ee a ee 


of SP instruction: 
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Here is an example of setting the rightmost part of a field to zeros. The contents of FIELD 
+ 2 (a 2-byte field) are subtracted from the contents of FIELD (a 4-byte field). The result 
replaces the rightmost two bytes of FIELD. The signs of both operands are positive and by 
the rules of algebra produces a positive result. This instruction operates from right to left. 
The SP instruction starts with the rightmost bytes of both operands regardless of the 
differences in length. If you are concerned with whole numbers only, you may want to 
zero-fill any undesired decimal places. This SP instruction is used as a method to zero-fill 
any decimal places to the right of the decimal point. 


Example: 
LABEL AOPERATIONA OPERAND 
1 10 16 
SP QTY , ITEMS 
QTY Dc P'-25! 
ITEMS oc P'}2! 
QTY before execution 0 12 ps 13 Packed decimal number 
of SP instruction: 
ITEMS before and after oss 21: C Packed decimal number 
execution of SP instruction: 


QTY after execution 


. . 0 ! 3 7 1 OD Packed decimal number 
of SP instruction: 


The SP instruction subtracts the contents of ITEMS (a 2-byte field) from the contents of 
QTY (a 2-byte field). The result replaces QTY and a zero fills the leftmost unused half-byte. 
The signs are different, however. Operand 2 is unsigned and assumed to be positive. 
Since the sign of operand 2 is positive, it is treated as negative. Now, both operands 1 and 
2 are negative and are added together. The sign of the result is negative since the rules of 
algebra determine that the sign of the operand with the highest absolute value (in addition 
and subtraction) determines the sign of the result. 
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UNPK 


9.14. UNPACK DECIMAL (UNPK) 





































OBJECT 
ADDRESSING W@ PROTECTION 
OPCODE | FORMAT | INST. ba 
ype pene CJ DATA (INVALID SIGN/DIGIT) | [J SIGNIFICANCE 
MNEM. (BYTES) || () DECIMAL DiviIDE C] SPECIFICATION: 









C] DECIMAL OVERFLOW 

C) execute 

CJ EXPONENT OVERFLOW 
CL] EXPONENT UNDERFLOW 
OC FIXED-POINT DIVIDE 

(-D FIXED-POINT OVERFLOW 
(] FLOATING-POINT DIVIDE 
(J OPERATION 


NOT A FLOATING-POINT REGISTER 

OP 1 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON FULL-WORD BOUNDARY 


OP 2 NOT ON DOUBLE-WORD 
BOUNDARY 


OP 1 NOT EVEN NUMBERED REGISTER 
OP 1 NOT ODD NUMBERED REGISTER 
NONE 


junex [es] ss | 6 | 
Condition Codes 


CltF RESULT = 0, SET TOO 
Of RESULT <O, SET TO1 
Clif RESULT >0, SET TO 2 
DIF OVERFLOW, SET TO 3 
BB UNCHANGED 


OOO OOOO0 


The unpack decimal (UNPK) instruction converts data in operand 2 from packed format to 
unpacked (zoned decimal) format. (See 9.1.) The result replaces operand 1. 


Explicit Format: 






A OPERATION A OPERAND 





[symbol] 





d, (I, b,),d, (I, .b, ) 


implicit Format: 


LABEL A OPERATION A OPERAND 





[symbol] UNPK s,(I,),s,(I,) 


Data that is to be printed or sent to any other character-sensitive device must be stored in 
zoned decimal format. Operand 2, the sending field, is defined as a packed field. Operand 
1, the receiving field, is defined as a character type or zoned type field. Operand 1 should 


contain enough bytes to receive all digits, a zone for each digit, and the sign from operand 
2. 


The formula for computing the number of bytes required to receive packed operand 2 data 
is: 


(Number of bytes of operand 2) x 2 —1 = number of bytes required 
for unpacked operand 1 
field. 
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The UNPK instruction reverses the zone and digit portion (the sign) of the rightmost byte of 
operand 2 and places it in the rightmost byte of operand 1. Each half byte of operand 2 is 
moved to a digit portion and a hexadecimal F (binary 1111) fills each zone portion in 
operand 1. The move takes place from right to left, consecutively. Any unfilled bytes that 
are part of the specified length for operand 1 are zero-filled. If the operand 1 field is too 
short, the leftmost bytes of operand 2 are truncated. 

Operational Considerations: 

=  Operand 2 data should be in packed decimal format. 


= =Operand 1 should contain enough bytes to receive all digits, a zone for each digit, and 
the sign from operand 2. 


= @§=«©This instruction operates from right to left. 
= Any unfilled bytes that are part of the specified length for operand 1 are zero-filled. 
= Specification of a length attribute for operands 1 and 2 is optional. 


= The condition code remains unchanged. 





Example: 
LABEL AOPERATIONA OPERAND 
1 10 16 
UNPK TOTALU (3) , TOTALP(2) 
TOTALU DS CL3 
TOTALP 0C P'125! 


TOTALU before execution 


of UNPK instruction: 5! c¢ 716 D 1 2 | Leftover data from a previous page 
i 

TOTALP before and after Trt? | ; ede ea 

execution of UNPK instruction: : acked decimal number 

TOTALU after execution Flo4 BE bg' | ve 4 Bo Gapacked decahel pumber 


of UNPK instruction: 


The UNPK instruction changes the packed format of TOTALP to unpacked format and 
places the result in TOTALU. The zone (5) and digit (C) portions of TOTALP are reversed 
and placed in the rightmost byte of TOTALU. The digit 2 fills the digit portion and a 
hexadecimal F fills the zone portion next to the rightmost byte. Then the digit 1 fills the 
digit portion and a hexadecimal F fills the zone portion to the left of the byte just filled. As 
you can see, the field requiring 2 bytes to store the original packed data now requires 3 
bytes to store the same data but in unpacked format. Note that a length attribute is 
specified for both operands, although it can be omitted. 
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@ Example: 


LABEL AOPERATIONA OPERAND 
1 10 16 

UNPK TOTAMT , TOTAMT 
TOTAMT DOC P'1234! 


TOTAMT before execution 


4 | C | Packed decimal numbe 
of UNPK instruction: aa a eal Nae 


TOTAMT during execution 
of UNPK instruction: 


TOTAMT after execution 
of UNPK instruction: 


N 
‘ 
oO 
Fe 


The UNPK instruction reverses the zone (4) and digit (C) portions and returns it to the 
same byte. The next half byte (3) replaces the digit portion and a hexadecimal F fills in the 
zone portion next to the half byte just filled. No length attributes are specified, so the 
implied lengths are used. As you can see, the result received is not the result expected. 
So, remember that unpacking a number into itself is not considered good practice since 
some results are often unpredictable. 
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9.15. ZERO AND ADD DECIMAL (ZAP) 


General Possible Program Exceptions 
OBJECT |) my ADDRESSING PROTECTION 
OPCODE FORMAT | INST. 
TYPE LGTH. 


P| DATA (INVALID SIGN/DIGIT) O SIGNIFICANCE 


(J DECIMAL DIVIDE D SPECIFICATION: 
[zap [re| ss | 6 | | DECIMAL OVERFLOW NOT A FLOATING-POINT REGISTER 
Condition Codes 


1) Execute OP 1 NOT ON HALF-WORD BOUNDARY 
O EXPONENT OVERFLOW OP 2 NOT ON HALF-WORD BOUNDARY 
C0 EXPONENT UNDERFLOW OP 2 NOT ON FULL-WORD BOUNDARY 

— ; DD FIXED-POINT DIVIDE OP 2 NOT ON DOUBLE-WORD 

7 ET TO 

a: Areata Ze ea OA 0 F!xED-POINT OVERFLOW BOUNDARY 

Wf RESULT >0O, SET TO 2 

BB iF OVERFLOW, SET TO3 

(J UNCHANGED 

























O FLOATING-POINT DIVIDE OP 1 NOT EVEN NUMBERED REGISTER 
(J OPERATION OP 1 NOT ODD NUMBERED REGISTER 
NONE 













DOO OOOO 


The zero and add decimal (ZAP) instruction moves a packed field of zeros into operand 1 
and then adds the packed contents of operand 2 to the packed field of zeros in operand 1. 
The result replaces operand 1. 


Explicit Format: 






A OPERATION A OPERAND 








Implicit Format: 


LABEL A OPERATION A OPERAND 
[symbol] | ZAP . s, (I, ),s, (Ip) 


This instruction operates in the same manner as the add decimal (AP) instruction except 
that a packed field of zeros is moved into operand 1 before the addition occurs. The sign of 
the packed field of zeros is positive. After the addition takes place the resultant sign is the 
same as operand 2. If operand 2 does not have a valid sign in the low order four bits, a 
data exception occurs. If an overflow condition occurs and the leftmost bytes are 
truncated, a zero result still has the sign of operand 2. In effect, the ZAP instruction 
replaces operand 1 with the contents of operand 2. The length of operand 1 should be the 
same as, or larger than, the length of operand 2. If the operand 1 field is not sufficient to 
receive all of operand 2, an overflow condition occurs. Operands 1 and 2 can have 
overlapping bytes when the rightmost byte of operand 1 coincides with, or is to the right 
of, the rightmost byte of operand 2, provided a valid sign exists in the low order four bits 
of operand 2. 
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Operational Considerations: 
= Operands 1 and 2 must be in packed decimal format. 


m = If the length of operand 2 is larger than the length of operand 1, the leftmost digits of 
operand 2 are truncated. 


a If the length of operand 1 is larger than operand 2, the leftmost digits of operand 1 
are zero-filled. 


= Operand 2 must have a valid sign in the low order four bits. 





Example: 
LABEL AOPERATIONA OPERAND 
1 10 16 
ZAP TOTAMT , YTDAMT 
TOTAMT OC P'S28416' 
YTDAMT OC P'215' 


TOTAMT before execution 


YTDAMT before and after Pata | Padkod decimal number 
execution of ZAP instruction: ida *° “ 


TOTAMT after execution ola ie sos Le Men 5 {| C | Packed decimal number 
of ZAP instruction: 


In this example, the ZAP instruction moves a packed field of zeros into TOTAMT and then 
adds the contents of YTDAMT to TOTAMT. As you can see, the contents of YTDAMT now 
replaces the contents of TOTAMT. In this sample program, TOTAMT contains a year’s total 
amount of sales, while YTDAMT contains the accumulative amount of sales. At the end of 
12 months, when the maximum amount of sales for the year is reached, TOTAMT must be 
cleared to zero, so that the amount of sales for the first month of the next year can be 
accumulated. 


Example: 


MVC CALC+1(1),=P'1' 
ZAP CALC+1 (2) ,CALC (2) 


CALC pc P'25124' 
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CALC before GXECUFON 2/5 112 41 C Packed decimal number 
of MVC instruction: 
operand 1 
eee 
CALC after execution fo 1s | i ea ee 
of MVC instruction: 
eed 
operand 2 
operand 2 


ais | 1 §C (stored) 
fo 10 | o:1 C Packed field of zeros 


2 1 «5 1/1 °C Packed decimal number 


CALC during execution 
of ZAP instruction: 


CALC after execution ach 


of ZAP instruction: 


In this example, operands 1 and 2 have one overlapping byte. The rightmost byte of 
CALC+1(2) (operand 1) is to the right of the rightmost byte of CALC(2) (operand 2). When 
the ZAP instruction is executed, a packed field of zeros with a positive sign is moved into 
operand 1. Then, the contents of operand 2 that has been saved prior to the execution of 
the ZAP instruction is now added to the packed field of zeros. In effect, the contents of 
operand 2 now replace the contents of operand 1. 
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10. Fixed-Point Binary Instructions 


10.1. USE OF FIXED-POINT BINARY INSTRUCTIONS 


If the fixed-point binary instruction set (RX, RR, or RS) is compared to the decimal 
instruction set (SS or Sl), you will discover that the difference between storage-to-storage 
type instructions and register type instructions is the location of the instruction operands. 
Both operands for decimal instructions are contained in main storage, while the operands 
for fixed-point instructions are either both in the processor or one in the processor and 
one in main storage. Any instruction operands located in main storage are transferred to 
the processor before execution. In fixed-point binary instructions, the RR type requires no 
transfer of operands, while the RX and RS types require transfer of only one. In decimal 
instructions, both operands are always transferred. This explains why execution time of 
fixed-point binary instructions is faster than execution time of decimal instructions. 


Execution time gained by arithmetic binary instructions over decimal instructions is lost, 
however, in the data conversion process. Both instruction sets must convert card input 
data in zoned decimal format (EBCDIC) to a data format acceptable to the instruction set. 
Decimal instruction input data must be converted to packed decimal format; fixed-point 
binary instruction input data must be converted to binary format. 


Conversion to packed format is faster than conversion to fixed-point binary format because 
binary conversion requires an additional instruction that has a slower execution time. To 
get input data into packed format, you use the PACK instruction; to output packed data, 
you must first unpack it with the UNPK or ED instruction. When converting input data to 
binary, the data must be packed first, then converted to binary (using the convert to binary 
(CVB) instruction). On output, data must be converted to packed decimal (using the convert 
to decimal (CVD) instruction) and then converted to unpacked or zoned decimal format. For 
input conversion, fixed-point binary instructions execute slower than decimal instructions. 
For a comparison of the execution times for decimal and fixed-point instructions, see the 
system hardware and software summary, UP-8203 (current version). 


Fixed-point instructions should be used in programs having less input data and more 
arithmetic calculations, whereas decimal instructions should be used in programs having 
more input data and less arithmetic calculations. This is why binary instructions are used 
in the design of FORTRAN compilers and decimal instructions are used in the design of 
COBOL compilers. 


There are 16 general registers located inside the processor that can be used as operands 
in fixed-point instructions. A decimal number (O through 15) is used to reference a 
register. This is similar to using labels when referencing main storage locations. 
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For all fixed-point instructions, operand 1 always references a register with the exception 
of the add immediate (Al) instruction, whose operands both reference main storage 
locations. The operand 1 register is usually the receiving field or resultant field after an 
instruction is executed. For the store (ST) and convert to decimal (CVD) instructions, 
however, operand 2 (a main storage location) is the resultant field. In fixed-point 
instructions, operand 2 references either a register (RR), or a main storage location (RX or 
RS). The compare instructions do not have a resultant field, since they test already existing 
conditions and have no effect on operands 1 and 2. 


To bring data from main storage into a register, it must be compatible with the structure of 
the register. A register is four bytes in length and uses 32 binary bits to represent a 
signed binary number. The high order bit position represents the sign. A binary 1 in the 
high order bit position represents a negative number, whereas a binary O in the high order 
- bit position represents a positive number. 


REGISTER (4 bytes) 


oZ07%" 


There are two ways to create data in fixed-point binary format: 


1. Use the convert to binary (CVB) instruction to convert a packed decimal number to a 
fixed-point binary number which is placed in a register. 


2. Use the define constant (DC) statement to create a constant that is defined as a half 
word, full word, or double word, or a constant that is aligned on a half-word, full- 
word, or double-word boundary. This constant is then placed in a register through 
execution of another instruction [i.e., Add (A), Load (L), Subtract (S)]. 


HALF WORD (2 bytes) 


Ss 

| 

G 

N 

0 

FULL WORD (4 bytes) 

Ss 

I 

G 

N 

0 1 31 

DOUBLE WORD (8 bytes) 

Ss 

' 

G 

N 

0 1 63 
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As shown, these formats are compatible with the formats of registers. Since registers are 
full words (4 bytes), only full words or half words in main storage (or other registers) can 
be specified as operand 2. When a half word value in main storage is specified as operand 
2, a full 4 bytes are used when that instruction is executed. Operand 2 is expanded to 32 
bits by propagating the sign bit value through the 16 high order bit positions. Expansion 
occurs after the operand is obtained and before insertion, comparison, or any 
mathematical calculations are performed with the register. 


10.1.1. Half-Word Fixed-Point Constants 


The character H is the definition type used for defining half-word fixed-point constants in 
main storage. The constants associated with this definition type must be enclosed within 
apostrophes, cannot exceed more than five decimal digits, and cannot have a value greater 
than +32767 (2'5-1) or less than -32768 (-2'5). Half-word constants are two bytes in 
length and aligned on a half-word boundary. If the constant specified does not occupy the 
full two bytes, it is right-justified and the high order unused bits are filled with the sign 
bit. Duplication factors can be used and the nominal value can be a signed or unsigned 
decimal number. Because the length of a half word is always two bytes, no length factor is 
required. If a length factor is specified, half-word boundary alignment is ignored and the 
specified length is allocated. 


Example: 


LOC. OBJECT CODE LINE SOURCE STATEMENT 


000002 39 4k PLUS] DC HL1'+57' 
000003 00 


000004 0039 5 PLUS2 H'57' 
000006 C7 6 NEGI HET =57° 
000007 00 

000008 FFC7 7 NEG2 Hes57" 





10.1.2. Full-Word Fixed-Point Constants 


The character F is the definition type used for defining full-word fixed-point constants in 
main storage. The constant associated with this definition type must be enclosed within 
apostrophes, cannot exceed more than 10 decimal digits, and cannot have a value greater 
than +2,147,483,647 (23'-1) or less than -2,147,483,648 (-231). Full-word constants are 
four bytes in length and aligned on a full-word boundary. If the constant specified does not 
occupy the full four bytes, it is right-justified and leftmost unused bits are filled with the 
sign bit. Duplication factors can be used and the nominal value can be a signed or 
unsigned decimal number. Because the length of a full word is always four bytes, no 
length factor is required. If a length factor is specified, full-word boundary alignment is 
ignored and the specified length is allocated. 
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Example: & 


LOC. OBJECT CODE LINE SOURCE STATEMENT 





O00000A O10F 8 PLUS3 DC FL2'+271' 
00000C 0000010F 9 PLUS4 DC F'271' 


000010 FEFI 10 NEG3 DC FL2*427 1" 
000012 0000. 
000014 FFFFFEF] 11 NEG4 DC F'-271' 





10.1.3. Address Constants 


Address constants are storage addresses that are stored as constants by using DC 
statements. Address constants are used to initialize base registers; thereby, providing 
communication between control sections of a multisection program. Unlike other types of 
constants, an address constant is enclosed within parenthesis. If more than one address 
constant is specified, they are separated by commas, and the entire sequence is enclosed 
within parenthesis. There are two types of address constants: half word (Y) and full word 
(A). 


10.1.3.1. Full-Word Address Constants 





This constant can be specified as an absolute, relocatable, or complex relocatable 
expression. It has a length of four bytes and is full-word boundary aligned. You cannot 
specify a value greater than +2,147,483,647 (23'-1) or less than -2,147,483,648 (-23'). To 
generate full-word address constants, use the DC statements with the character A as the 
definition type and the expressions specified enclosed within parenthesis. You can also 
generate full-word address constants as literals. The address of these expressions are 
stored in consecutive full words in main storage. However, if a length factor is specified, 
full-word boundary alignment is ignored and the specified length is allocated. 


Example: 





LOC. OBJECT CODE ADDR} ADDR2 LINE SOURCE STATEMENT 
000002 5 TAG DS CL3 

000005 6 HOURS DS CL2 

000007 7 RATE DS CL4 

000008 8 PAY DS CL3 

OOOO0E 9 LABEL DS CL6 

000014 10 TAGI DS CL3 

000017 T1 BUF DS CL4 

00001B ; 12 TAG2 DS CL3 

OOOO1E 13 ADLIST DS CL20 
000032 0000 

000034 O0000006A 14 ADCONI DC A(106,TAG, *+526) 


000038 00000002 

00003C 0000024A 

000040 

000040 00000007 15 ADCON2 dC A(RATE, HOURS, PAY) 
000044 00000005 

000048 0000000B 





00004C 
O0004C 9858 3056 00058 16 ADCON3 LM 5,8,=A(88,LABEL, TAG1- TAG2, BUF+64] 
000050 OOO000ITE 17 ADCON4S DC A(ADLIST) 
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10.1.3.2. Half-Word Address Constants 


This constant can be specified as an absolute, relocatable, or complex relocatable 
expression. It has a length of two bytes and is half-word boundary aligned. You cannot 
specify a value greater than +32767 (215-1) or less than -32768 (-2'5). To generate half- 
word address constants, use the DC statements with the character Y as the definition type 
and the expressions specified enclosed within parenthesis. You can also generate half- 
word address constants as literals. The addresses of these expressions are stored in 
Consecutive half words in main storage. However, if a length factor is specified, half-word 
boundary alignment is ignored and the specified length is allocated. 


LOC. OBJECT CODE LINE SOURCE STATEMENT 


000002 500C VALUE DC PL2'500' 
000004 00000001 NUM DC zeae 
000008 F3F6F2 POS DC X'F3F6F2' 
00000B 60 NEG DC CLI'-8! 
QO000C F6F2F4F7CO ZONE DC ZL5'62470' 
000011 00 

000012 O00B ADCONY!] DC Y (NEG, POS) 


000014 0008 

000016 

000016 0116 ADCONY2 DC  Y(%*+256,600) 

000018 0258 

00001A 0008 ADCONY3 DC -Y(VALUE+6) 

OO00IC 

00001C 0019000A . ADCONY4 DC Y(25,ZONE-VALUE,NUM, POS+4) 
000020 0004 

000022 000 

000024 





10.1.4. Representation of Positive and Negative Fixed-Point Binary Numbers 


Binary ones and zeros, with relation to their positions in a string of bits, represent values 
expressed in powers of two (see Appendix C.3). The powers of two increase from right to 
left (Figure 10—1). A zero (0) bit indicates no value and a one (1) bit indicates that a value 
exists. By adding all the powers of two that correspond to one bits, you can determine the 
decimal equivalence for a positive binary number. A zero bit in the high order bit or any 
unused high order bits signify a positive binary number. 


+ sign 


0,001 11010} 1100 !0101 


0 78 15 


(powers 


of two) 36 


(binary 0 0 0 1 1 o 1 0 1 1 0 0 ) 1 0 1 


configuration) | L 1 (29) 
4 (22) 
64 = (28) 





128 = (27) 
512 (29) 
2048 (2! 1) 
4096 = (2! 8) 
6853 (decimal 


equivalent) 


Figure 10-1. Comparison of Binary Numbers and Values Expressed in Powers of 2 
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Negative binary numbers are indicated by a 1 bit in the high order bit position or any & 


unused high order bit positions. The remaining portion contains the negative binary 


number but in twos complement form. To change a positive binary number into twos 


complement form: 


- reverse the bits; and 


- add one to the rightmost or low order bit position. 


0001101011000101 


1110010100111010 
+1 





1110010100111011 


positive binary number 
(decimal + 6,853) 


reversed bits 
add 1 


binary number in twos complement form 
(decimal — 6,853) 
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10.2. ADD (A) 


General 




































srdowe OBJECT |) gy ADDRESSING 
FORMAT | INST. 
ae er [J DATA (INVALID SIGN/DIGIT)|] O 





LJ DECIMAL DivIDE 

(J DECIMAL OVERFLOW 

OO Execute 

(] EXPONENT OVERFLOW 
(0 EXPONENT UNDERFLOW 
CJ FIXED-POINT DIVIDE 

@ FIXED-POINT OVERFLOW 
CJ FLOATING-POINT DIVIDE 
(J OPERATION 


(BYTES) 


Condition Codes 


Mir RESULT = 0,SET TOO 
Mir RESULT <0, SETTO1 
Wir RESULT >0O, SET TO2 
BB IF OVERFLOW, SET TO 3 
CL] UNCHANGED 










OOO Ow8oOoOO0 


Possible Program Exceptions 


@ PROTECTION 


10-7 


SIGNIFICANCE 

SPECIFICATION: 
NOT A FLOATING-POINT REGISTER 
OP 1 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON FULL-WORD BOUNDARY 


OP 2 NOT ON DOUBLE-WORD 
BOUNDARY 


OP 1 NOT EVEN NUMBERED REGISTER 
OP 1 NOT ODD NUMBERED REGISTER 
NONE 


The add (A) instruction algebraically adds the full-word main storage contents of operand 2 
to the contents in the operand 1 register and stores the sum in operand 1. 


Explicit Format: 









LABEL A OPERATION A 





[symbol] 


Implicit Format: 









A OPERATION A 


[symbol] 


Operational Considerations: 


OPERAND 


OPERAND 


= ~§=Any of the general registers (0 through 15) can be used as operand 1. 
= Operand 2 must either be defined as a full word or aligned on a full-word boundary. 
=» If the sum exceeds 31 bit positions, an overflow condition occurs. 
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Example: 
LABEL AOPERATIONA OPERAND 
] 10 16 
SR 6,6 
A 6,FULLWORD 
FULLWORD DC F'+271' 


Register 6 before execution of A instruction: 


0000 ; 0000 | 0000 | 0000 | 0000 | 0000 | 0000 , 0000 


FULLWORD before and after execution of A instruction: 


0000 | 0000 | 0000 | 0000 | 0000 | 0001 | 0000 ; 1111 






binary 
hex 

















binary 
Register 6 after execution of A instruction: 
t 
0000 | 0000/0000 !0000} 0000! 0001 |0000 }1111 em 


hex 


ieee ee ee 


In this example, the SR instruction subtracts the content of register 6 from itself, clearing 
it to zero. Then the content of FULLWORD is added to the content of register 6. The result 
replaces the content of the operand 1 register. 
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AR 


10.3. ADD (AR) 


Possible Program Exceptions 


[J ADDRESSING (1 PROTECTION 

(C0 DATA (INVALID SiGN/DIGIT)| L) SIGNIFICANCE 

(1 DECIMAL DIVIDE CJ SPECIFICATION: 

CJ DECIMAL OVERFLOW NOT A FLOATING-POINT REGISTER 
CJ execute OP 1 NOT ON HALF-WORD BOUNDARY 
OC EXPONENT OVERFLOW OP 2 NOT ON HALF-WORD BOUNDARY 
CX EXPONENT UNDERFLOW OP 2 NOT ON FULL-WORD BOUNDARY 
CO FIXED-POINT DIVIDE OP 2 NOT ON DOUBLE-WORD 


@ FIxXED-POINT OVERFLOW BOUNDARY 
C FLOATING-POINT DIVIDE OP 1 NOT EVEN NUMBERED REGISTER 


(J OPERATION OP 1 NOT ODD NUMBERED REGISTER 
NONE 


OBJECT 
OPCODE FORMAT | INST. 
TYPE LGTH. 


MNEM., |HEX., (BYTES) 





Condition Codes 


WM iF RESULT =0,SET TOO 
Wir Result <o,setto1 
BB if RESULT > 0, SET TO 2 






WF OVERFLOW, SET TO3 
[] UNCHANGED 





Oo 
i) 
O 
O 
O 
O 
O 
O 


The add (AR) instruction algebraically adds the contents of the operand 2 register to the 
contents of the operand 1 register and stores the sum in operand 1. 


Explicit and Implicit Format: 






A OPERATION A OPERAND 


[symbol] 


Operational Considerations: 
a Any of the general registers (0 through 15) can be used as operands 1 and 2. 


a If the sum exceeds 31 bit positions, an overflow condition occurs. 





Example: 
LABEL AOPERATIONA OPERAND 
] 10 16 
L 5, NUM] 
L 6 ,NUM2 
AR 5,6 
NUM] DC F'22! 


NUM2 DC F'l6! 





UP-8061 Rev. 3 SPERRY UNIVAC 0S/3 10—10 
ASSEMBLER 


Register 5 before execution of AR instruction: 


0000 1 0000 | 0000 10000 | 0000 ; 0000/0001 10110 


Register 6 before and after AR instruction: 


}0000 |0000 {0000 | 0000 10000 | 0001 ;0000 


Register 5 after execution of AR instruction: 






binary 
hex 














binary 
hex 





0000 !0000 |0000 10000 | 0000 | 0000 }0010 10110 


binary 


in this example, the contents of NUM1 is loaded into register 5 and the contents of NUM2 
is loaded into register 6. Then, the contents of register 6 is added to the contents of 
register 5. The result is placed in register 5 (operand 1). Notice that both NUM1 and NUM2 
are fullwords. 
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AH 


10.4. ADD HALF WORD (AH) 


Possible Program Exceptions 


HB ADDRESSING BB PROTECTION 

(J DATA (INVALID SIGN/DIGIT) | [] SIGNIFICANCE 

(] DECIMAL DiviIDE WE SPECIFICATION: 

OO DECIMAL OVERFLOW NOT A FLOATING-POINT REGISTER 

C] execute OP 1 NOT ON HALF-WORD BOUNDARY 
(J EXPONENT OVERFLOW OP 2 NOT ON HALF-WORD BOUNDARY 
C EXPONENT UNDERFLOW OP 2 NOT ON FULL-WORD BOUNDARY 
OD FIXED-POINT DIVIDE OP 2 NOT ON DOUBLE-WORD 

@ FIXED-POINT OVERFLOW BOUNDARY 

C1 FLOATING-POINT DIVIDE OP 1 NOT EVEN NUMBERED REGISTER 
CO] oPeration OP 1 NOT ODD NUMBERED REGISTER 

NONE 













OBJECT 
OPCODE FORMAT | INST. 
TYPE LGTH. 


MNEM. (BYTES) 


Condition Codes 


MirF RESULT = 0,SET TOO 



































Wie Resuct <o,setto1 
Wie RESULT >0, SET TO 2 
Gif OVERFLOW, SET TO3 
(J UNCHANGED 










OOO OO8O00 


The add half-word (AH) instruction algebraically adds the contents of operand 2 to the 
contents of the operand 1 register and puts the sum in operand 1. 


Explicit Format: 









LABEL AOPERATION A OPERAND 





[symbol] 


Implicit Format: 






A OPERATION A OPERAND 


[symbol] 


Operand 2 is two bytes in length (16-bit signed integer) and is located in main storage. 
Before operand 2 is added to the operand 1 register, operand 2 is temporarily expanded to 
32 bits by propagating the sign bit through the high order 16 bit positions. Then all 32 bits 
of operand 2 are added to the 32 bits of operand 1. The result is placed in operand 1. If 
the sum exceeds 31 bits, an overflow condition occurs. 

Operational Considerations: 

. Operand 2 must be either defined as a half word or half-word boundary aligned. 


= §6Any of the general registers (0 through 15) can be used as operand 1. 


= A fixed-point overflow condition can occur. 
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Example: 

LABEL AOPERATIONA OPERAND 
] 10 16 

L 5,FULLWORD 

AH 5,HALFWORD 
FULLWORD DC F'32' 
HALFWORD DC H'16' 


Register 5 before execution of AH instruction: 


binary 
hex 


2! 0 





HALFWORD before and after execution of AH instruction: 


before expanding to 32 bits 


ea T i 
10000 ; 0000 {0000 10000 | 0000 ,;0000 





0001 !0000 7 
binary 








after expanding to 32 bits 


Register 5 after execution of AH instruction: 


0000 | 0000 ;0000 !0000 }0000 ; 0000; 0011 10000 


In this example, the content of FULLWORD is loaded into register 5. Then the content of 
HALFWORD is added to the content of register 5. The result is placed in register 5 
(operand 1). If the sum exceeds 31 bits, an overflow condition occurs. 





binary 
hex 
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10.5. ADD IMMEDIATE (Al) 


OPCODE FORMAT 
TYPE 


OBJECT 
INST. 
LGTH. 
(BYTES) 





Hi ADDRESSING 

(0 DATA (INVALID SIGN/DIGIT) 
(O DECIMAL DiviDE 

C] DECIMAL OVERFLOW 

OJ execute 

( EXPONENT OVERFLOW 

C] EXPONENT UNDERFLOW 

C1 FIXED-POINT DIVIDE 







Condition Codes 





SPERRY UNIVAC 0S/3 


Possible Program Exceptions 


Mi PROTECTION 
(LD SIGNIFICANCE 
WB SPECIFICATION: 














10—13 


Al 









NOT A FLOATING-POINT REGISTER 
OP 1 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON FULL-WORD BOUNDARY 
OP 2 NOT ON DOUBLE-WORD 






















Mir RESULT =0,SET TOO 
Wir Resutt <o,setto1 
Wir RESULT >O, SET TO 2 
Gif oVERFLOW, SET TO 3 
(J UNCHANGED 


BOUNDARY 

OP 1 NOT EVEN NUMBERED REGISTER 

OP 1 NOT ODD NUMBERED REGISTER 
NONE 


W@ FIxeD-POINT OVERFLOW 
0 FLOATING-POINT DIVIDE 
CO OPERATION 


OOO OOOS8D 


The add immediate (Al) instruction algebraically adds the 1-byte immediate data in 
operand 2 to the half word value in operand 1. The sum is placed in operand 1. 


Explicit Format: 






A OPERATION A OPERAND 


[symbol] 


Implicit Format: 


LABEL A OPERATION A OPERAND 
[symbol] | Al S, i, 


Operand 1 must be either defined as a half word or is half-word boundary aligned. 
Operand 2 must be a 1-byte self-defining term. Before operand 2 is added to the half word 
in operand 1, operand 2 is temporarily expanded to 16 bits by propagating the sign bit 
through the high order 8 bit positions. Then all 16 bits in operand 2 are added to the 16 
bits in operand 1. The result is placed in operand 1. If the sum exceeds 15 bit positions, an 
overflow condition occurs. 


Operational Considerations: 
=  Operand 1 must be either defined as a half word or aligned on a half-word boundary. 


= During execution of the Al instruction, operand 2 is temporarily expanded to 16 bit 
positions. The leftmost eight bits are the same as the sign bit. 


UP-8061 Rev. 3 SPERRY UNIVAC OS/3 10—14 
ASSEMBLER 


= Operand 2 must be a 1-byte self-defining term (see 4.4). 





= You may not specify an immediate value greater than +127 (2’—1) or less than 
—128 (—2’) in operand 2. 


= If the sum exceeds 15 bit positions, an overflow condition can occur. 





Example: 
LABEL AOPERATIONA OPERAND 
| 10 16 
Al STORAGE, 1 
STORAGE OC H'3! 


STORAGE before execution of Al instruction: 





Operand 2 immediate before and after execution of Al instruction: 


0000 10001 binary 


hex 


STORAGE after execution of Al instruction: 


0000 10000 |0000 10100 


In this example, the immediate value in operand 2 is added to the half-word value in 
STORAGE. The result replaces the contents of STORAGE. 











binary 
hex 
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10.6. COMPARE (C) 


OBJECT 
OPCODE FORMAT | INST. 


Mi ADDRESSING Bi PROTECTION 

C0 DATA (INVALID SIGN/DIGIT) | L] SIGNIFICANCE 

(CJ DECIMAL DivIDE M@ sPEcIFICATION: 

DC DECIMAL OVERFLOW NOT A FLOATING-POINT REGISTER 
OJ execute OP 1 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON FULL-WORD BOUNDARY 


OP 2 NOT ON DOUBLE-WORD 
BOUNDARY 


OP 1 NOT EVEN NUMBERED REGISTER 
OP 1 NOT ODD NUMBERED REGISTER 
NONE 


TYPE LGTH. 
MNEM. JHEX. (BYTES) 


Condition Codes 


WW ifr, = OPERAND 2,SET TOO 
@ iF r, <OPERAND 2, SET TO1 
@ Fr, > OPERAND 2, SET TO 2 
Cite OVERFLOW, SET TO 3 

C) UNCHANGED 





CJ EXPONENT OVERFLOW 
D0 ExPONENT UNDERFLOW 
OO FIXED-POINT DIVIDE 

0 FIXED-POINT OVERFLOW 
(J FLOATING-POINT DIVIDE 
(1 OPERATION 







OOO Owooo 





The compare (C) instruction algebraically compares the contents in the operand 1 register 
to the full word in operand 2. The result determines the setting of the condition code. (See 
condition code settings, 8.5.) 


@ Explicit Format: 






A OPERATION A OPERAND 





[symbol] r, d, (x, b,) 


Implicit Format: 






A OPERATION A OPERAND 


[symbol] 


The operand 1 register is compared to a 32-bit signed integer (operand 2) located on a full- 
word boundary in main storage. The result of the comparison determines the setting of the 
condition code, bits 34 and 35 of the PSW. (See 8.1.) 

If operand 1 = operand 2, set to O. 

If operand 1 < operand 2, set to 1. 


lf operand 1 > operand 2, set to 2. 
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Usually, a conditional branch instruction tests the resulting condition code for an equal to 
zero, less than zero, or greater than zero condition. If the condition is met, a branch takes 
place. If not the program continues processing as shown in the following coding 
instruction. 





Operational Considerations: 
= ~§©Any of the general registers (0 through 15) can be used as operand 1. 
=  Operand 2 must be either defined as a full word or aligned on a full-word boundary. 


= Neither operand is changed by the execution of the instruction. 








Example: 
LABEL AOPERATIONA OPERAND 
1 10 16 
SR 7,7 
L 5 ,AMOUNT 
C 5, FULLWORD 
BE ROUTINE 
A 6,=F'l! 
ROUTINE AR 7,5 
FULLWORD DC F'32! 
AMOUNT DC F'32! 


Register 5 before and after execution of C instruction: 









| 0000 10000 | 0000 | 0000 }0010 ;0000 
eee a) 


FULLWORD before and after execution of C instruction: 


0000 !0000 |0000 10000 | 0000 | 0000 |0010 ; 0000 


In this example, the full word in AMOUNT is loaded into register 5. Then, the content of 
register 5 is compared to the full word in FULLWORD. Since they compare equally, the 
condition code is set O and a branch to the instruction labeled ROUTINE takes place. If 
they do not compare equally, the A instruction following the BE instruction is executed 
and the program continues processing. 


binary 
hex 





binary 
hex 
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CR 


10.7. COMPARE (CR) 


Possible Program Exceptions 
FORMA 
TYPE MG TE (CO DATA (INVALID SIGN/DIGIT)| [] SIGNIFICANCE 


(pytes) || C] DECIMAL DIVIDE CO SPECIFICATION: 


O DECIMAL OVERFLOW NOT A FLOATING-POINT REGISTER 


C1] EXPONENT OVERFLOW OP 2 NOT ON HALF-WORD BOUNDARY 
Condition Codes C0 EXPONENT UNDERFLOW OP 2 NOT ON FULL-WORD BOUNDARY 


OO FIXED-POINT DIVIDE OP 2 NOT ON DOUBLE-WORD 
Gif RESULT <0, SET TO 1 0 FIXED-POINT OVERFLOW BOUNDARY 
GI ir RESULT > 0, SET TO2 C1 FLOATING-POINT DIVIDE OP 1 NOT EVEN NUMBERED REGISTER 


CIF OVERFLOW, SET TO 3 C OPERATION OP 1 NOT ODD NUMBERED REGISTER 
[J UNCHANGED NONE 


Wir RESULT =0,SET TOO 





The compare (CR) instruction algebraically compares the contents in the operand 1 register 
to the contents in the operand 2 register. The result determines the setting of the 
condition code. (See condition code settings, 8.5.) 


Explicit and Implicit Format: 






A OPERATION A OPERAND 


[symbol] 


The 32 bits of operand 1 are compared to the 32 bits of operand 2. The result determines 
the setting of the condition code, bits 34 and 35 of the PSW. (See 8.1.) 


If operand 1 =operand 2, set to O. 

if operand 1 < operand 2, set to 1. 

If operand 1 > operand 2, set to 2. 
Usually, a conditional branch instruction tests the resulting condition code for an equal to, 
less than, or greater than condition. If the condition is met, a branch takes place 
accordingly. If not, the program continues processing as shown in the following coding 
instruction. 
Operational Considerations: 


= §6Any of the general registers (0 through 15) can be used as operands 1 and 2. 


a Neither operand is changed by the instruction. 
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Example: 

LABEL AOPERATIONA OPERAND 
| 10 16 

SR 7,7 

L 5 ,AMOUNT 

L 6 , VALUE 

CR 5,6 

BH ROUT INE 

AR 7,5 
ROUTINE Al ERCNT,1 
AMOUNT DC F'32' 
VALUE oc F'32' 
ERCNT DC H'g! 


Register 5 before and after execution of CR instruction: 


0000 |0000 | 0000 10000 | 0000 ; 0000 |0010 , 0000 


Register 6 before and after execution of CR instruction: 


0000 ,0000 | 0000 10000 | 0000 1 0000 | 0000 | 0000 
Ee eee Ee 


In this example, the full word in AMOUNT is loaded into register 5 and the full word in 
VALUE is loaded into register 6. Then the content of register 5 is compared to the content 
of register 6. Since they compare equally, the condition code is set to 0. The next branch 
instruction (BH) tests for a greater than (high) condition. Since both registers compare 
equally, no branch is taken and the instruction following the BH instruction (AR) is 
executed and the program continues processing. 





binary 
hex 













binary 
hex 
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CH 


10.8. COMPARE HALF WORD (CH) 


General 
OBJECT 
OPCODE FORMAT | INST. 
TYPE LGTH. 


Possible Program Exceptions 


BB ADDRESSING WW PROTECTION 

(J DATA (INVALID SIGN/DIGIT) | [] SIGNIFICANCE 

(1) DECIMAL DiviDE (CD SPECIFICATION: 

0 DECIMAL OVERFLOW NOT A FLOATING-POINT REGISTER 

(1) Execute OP 1 NOT ON HALF-WORD BOUNDARY 
(1 EXPONENT OVERFLOW OP 2 NOT ON HALF-WORD BOUNDARY 
(EXPONENT UNDERFLOW OP 2 NOT ON FULL-WORD BOUNDARY 
DD FIX€D-POINT DIVIDE OP 2 NOT ON DOUBLE-WORD 

CJ FIXED-POINT OVERFLOW BOUNDARY 

(0 FLOATING-POINT DIVIDE OP 1 NOT EVEN NUMBERED REGISTER 
C operation OP 1 NOT ODD NUMBERED REGISTER 

NONE 























MNEM. (BYTES) 


Condition Codes 


tf r, = OPERAND 2, SET TOO 




















@ iF r, SOPERAND 2, SET TO1 
wire, > OPERAND 2, SET TO 2 
CIF OVERFLOW, SET TO 3 

CC] UNCHANGED 













OOO OO800 





The compare half word (CH) instruction algebraically compares the contents in the operand 
1 register to the half word in operand 2. The result of the comparison determines the 
setting of the condition code. 


Explicit Format: 






A OPERATION A OPERAND 


[symbol] rd, (x, ,b,) 


Implicit Format: 






A OPERATION A OPERAND 


[symbol] 
Operand 2 is two bytes in length (16-bit signed integer) and is located in main storage. 
Before operand 2 is compared with the operand 1 register, operand 2 is temporarily 
expanded to 32 bits by propagating the sign bit through the high order 16 bit positions. 
Then all 32 bits of operand 1 are compared to the 32 bits in operand 2. The result 
determines the setting of the condition code, bits 34 and 35 of the PSW. (See 8.1.) 

If operand 1 = operand 2, set to O. 


If operand 1 < operand 2, set to 1. 


If operand 1 > operand 2, set to 2. 
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Usually, a conditional branch instruction tests the condition code for an equal to, less 
than, or greater than condition. If the condition is met, a branch takes place accordingly. If 
not, the program continues processing as shown in the following coding instruction. 
Operational Considerations: 

# §6Any of the general registers (0 through 15) can be used as operand 1. 


= = =Operand 2 must be either defined as a half word or aligned on a half-word boundary. 


= Neither operand is permanently changed by the execution of the instruction. 





Example: 
LABEL AOPERATIONA OPERAND 
] 10 16 
L 5 AMOUNT 
CH 5 ,HALFWORD 
BH ROUTINE 
AR 8,5 
ROUTINE A 6,=F'1' 
AMOUNT OC F' 32! 
HALFWORD DC H'16! 


Register 5 before and after execution of CH instruction: 


0000 ; 0000 | 0000 ; 0000 0000! 0000 0010/0000 
a0, Gi SG fee 


HALFWORD before and after execution of CH instruction: 





binary 
hex 





operand 2 before expansion 





operand 2 after expansion 


In this example, the full word in AMOUNT is loaded into register 5. Then, the content of 
register 5 is compared to the half word in HALFWORD. Since the content of register 5 is 
greater than the content of HALFWORD, the condition code is set to 2. The next branch 
instruction (BH) tests for a greater than (high) condition. Since a greater than condition 
exists, a branch to the instruction labeled ROUTINE taken place. 
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CVB 


10.9. CONVERT TO BINARY (CVB) 


Possible Program Exceptions 


Hi ADDRESSING Mi PROTECTION 
BB DATA (INVALID SIGN/DIGIT) L) SIGNIFICANCE 
(O DECIMAL DIVIDE WI SPECIFICATION: 





OBJECT 
INST. 
LGTH. 
(BYTES) 


OPCODE 







FORMAT 
TYPE 






MNEM. 


( DECIMAL OVERFLOW 

CO execute 

0 EXPONENT OVERFLOW 
CO] exPONENT UNDERFLOW 
@ FIxXe0-POINT DIVIDE 

C0 FIXED-POINT OVERFLOW 
(CJ FLOATING-POINT DIVIDE 














Condition Codes 







OIF RESULT =0,SET TOO 
Clie RESULT <0, SET TO1 
LiF RESULT > 0, SET TO 2 


NOT A FLOATING-POINT REGISTER 

OP 1 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON FULL-WORD BOUNDARY 


OP 2 NOT ON DOUBLE-WORD 
BOUNDARY 


OP 1 NOT EVEN NUMBERED REGISTER 
OP 1 NOT ODD NUMBERED REGISTER 




























CIF OVERFLOW, SET TO 3 


= (J OPERATION 
UNCHANGED 






OOO swOoo0o0 


NONE 


The convert to binary (CVB) instruction converts the packed decimal contents of the double 
word in operand 2 to its binary equivalent and puts the result in the operand 1 register. 


Explicit Format: 








A OPERATION A OPERAND 





[symbol] r, d,(x,,.b,) 


Implicit Format: 






A OPERATION A OPERAND 


[symbol] 


The CVB instruction converts a packed decimal number into a binary number. The operand 
1 register contains the resulting binary number (4 bytes in length) and operand 2 is a 
packed number (8 bytes in length) aligned on a double-word boundary. Operand 2 is 
checked for a valid sign in the low order four bits. The remaining 60 bits represent a 
decimal value not exceeding 15 decimal digits. The largest decimal number that can be 
converted is +2,147,483,647 (231 —1) and the smallest is -2,147,483,678 ( —23'). Any 
decimal number outside this range causes a fixed-point decimal divide. The result of the 
conversion is placed in the operand 1 register. The sign value (low order four bits) of the 
packed decimal number in operand 2 becomes the sign value (high order bit or bits) of the 
binary number in the operand 1 register. 


Operational Considerations: 


= § Any of the general registers (0 through 15) can be used as operand 1. 
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= Operand 2 must contain a packed decimal number aligned on a double-word 
boundary. 





= ~=If the sign value of the packed decimal number in operand 2 is positive, the sign value 
of the binary number in operand 1 is positive. 


= = If the sign value of the packed decimal number in operand 2 is negative, the binary 
number in operand 1 is represented in two’s complement form and the sign value is 
negative. 


= ~§©The condition code remains unchanged. 


= There is no conversion between EBCDIC and binary. EBCDIC data must first be 
packed, then converted to binary. 





Example: 
LABEL AOPERATIONA OPERAND 
1 10 16 
renee tt 
SR 7,7 
SR 55 
L 6,=F'1gg' 
PACK DBLWODP , AMT (3) 
CVB 5,DBLWDP 
CR 5,6 
BH ERRTN 
AR 7,5 
ERRTN A hose y! 
DBLWDP 0S D 
AMT Dc ZL3'428! 


Register 5 before execution of CVB instruction: 


0000 ! 0000 | 0000 ; 0000 | 0000 | 0000 |0000 ; 0000 


binary 
hex 
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DBLWDP before and after execution of CVB instruction: 
Packed 
number 


Register 5 after execution of CVB instruction: 


sign bits 





in this example, the SR instruction cleared both register 5 and 7 to zero by subtracting the 
' contents of the registers from themselves. Then, a full-word value of 100 is loaded into 
register 6. The contents of AMT is packed into DBLWDP and the CVB instruction converts 
the packed decimal value into its binary equivalent which replaces the contents of register 
5. Register 5 is then compared to register 6. Since the value of the contents in register 5 
is greater than that of register 6, the condition code is set to 2. The BH instruction then 
tests for a greater than condition and a branch to the instruction labeled ERRTN takes 
place. If the condition code is not 2, no branch takes place and the program continues 
processing with the instruction following the branch. 
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CvD 


10.10. CONVERT TO DECIMAL (CVD) 


OBJECT ADDRESSING @ PROTECTION 
OPCODE FORMAT | INST. a 
TYPE LGTH. 

















1] DATA (INVALID SIGN/DIGIT) CD SIGNIFICANCE 
| MNem. | HEX. | (BYTES) 


(C1 DECIMAL DIVIDE C] SPECIFICATION: 
Cj DECIMAL OVERFLOW NOT A FLOATING-POINT REGISTER 
| evo jae] ax | 4s | 
Condition Codes 


CO Execute OP 1 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON FULL-WORD BOUNDARY 
Pie Resi meena a OP 2 NOT ON DOUBLE-WORD 
Or RESULT <0, SETTO1 
(J iF RESULT >0, SET TO 2 
(Ff OVERFLOW, SET TO 3 


BOUNDARY 
MB UNCHANGED 


(J EXPONENT OVERFLOW 
1 EXPONENT UNDERFLOW 
CJ FIXED-POINT DIVIDE 

DO FIXED-POINT OVERFLOW 
C FLOATING-POINT DIVIDE 
(] OPERATION 


OP 1 NOT EVEN NUMBERED REGISTER 
OP 1 NOT ODD NUMBERED REGISTER 
NONE 





OOO woooo 


The convert to decimal (CVD) instruction converts the binary number in the operand 1 
register into its packed decimal equivalence and stores the result in the double word in 
operand 2. 


Explicit Format: 






A OPERATION A OPERAND 


[symbol] r, .d,(x,,b,) 


Implicit Format: 






A OPERATION A OPERAND 


[symbol] 


The CVD instruction converts a binary value into a packed decimal value. Operand 1 
register contains the binary value (4 bytes) and operand 2 contains a double-word field in 
packed decimal format (8 bytes). The largest decimal number that can be represented in 
binary in the operand 1 register is +2,147,483,647 (23'-1) and the smallest is 
— 2,147,483,648 ( —23'). Since the number to be converted is a 32-bit signed integer from 
a register and there are 15 decimal digits available for its decimal equivalent, an overflow 
condition cannot occur. 


The sign value (high order bit or bits) of the binary number in the operand 1 register 
becomes the sign value (low order four bits) of the packed decimal number in operand 2. 
The result of the conversion is placed in the doubleword of operand 2. Note that the CVD 
instruction is one of the few instructions that has operand 1 as the sending field and 
operand 2 as the receiving field. 
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Operational Considerations: 


= Any of the general registers (0 through 15) can be used as operand 1. 


10—25 


= Operand 2 must be either defined as a double word or aligned on a double-word 


boundary. 


= §=6lf the sign value of the binary number is positive, the sign value of the decimal 


number is positive. 


7 lf the sign value of the binary number represented in two’s complement form is 
negative, the sign value of the decimal number is negative. 


= ~§=6The condition code remains unchanged. 


= § The result is stored in operand 2, unlike most instructions, where operand 1 is the 


receiving field. 





Example: 
LABEL AOPERATIONA OPERAND 
1 10 16 
SR 7,7 
PACK DBLEWRD ,CARDIN+9(3) 
CVB 4 ,DBLEWRD 
AR 7,4 
BZ NOPAY 
cvD 4 , DBLEWRD 
ZAP TOTHRS , DBLEWRD 
NOPAY A 9,=F'1' 
CARDIN Dc CL8Q'SMITH,J. 480 WKTOT EXEMPT X! 
DBLEWRD DS D 
TOTHRS DS PL3 


DBLEWRD before execution of CVD instruction: 


Rec RE Pes eee Se ee 


Packed 
decimal 
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Register 4 before execution of CVD instruction: 





DBLEWRD after execution of CVD instruction: 


decimal 


In this example, register 7 is cleared to zero. A field from card input (CARDIN+9), which is 
EBCDIC and in zoned decimal format, is packed into DBLEWRD. The CVB instruction then 
converts the packed decimal number in DBLEWRD into its binary equivalent and puts the 
result into register 4. The content of register 4 is added to register 7. The condition code is 
set to 2, since the result of the addition is greater than zero. The next branch instruction 
(BZ) tests for an equal-to-zero condition. Since that condition does not exist, no branch 
takes place and the instruction following the branch instruction is executed. The CVD 
instruction then converts the contents of register 4 into its decimal equivalent and puts 
the result into DBLEWRD. The ZAP instruction clears TOTHRS to zero and adds the packed 
decimal number in DBLEWRD to TOTHRS. (This is an example where truncation is 
beneficial.) 
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10.11. DIVIDE (D) 


Possible Program Exceptions 
OBJECT 
ADDRESSING @ PROTECTION 
OPCODE FORMAT | INST. a 
TVPE GOTH. ( DATA (INVALID SIGN/DIGIT)| [] SIGNIFICANCE 


Pave re] 
OJ DECIMAL OVERFLOW 
Po fw] mx | 4 [occur 


(Bytes) ||) OECIMAL DIVIDE WB SPECIFICATION: 

NOT A FLOATING-POINT REGISTER 
OP 1 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON FULL-WORD BOUNDARY 


OP 2 NOT ON DOUBLE-WORD 
BOUNDARY 


OP 1 NOT EVEN NUMBERED REGISTER 
OP 1 NOT ODD NUMBERED REGISTER 
NONE 


OC EXPONENT OVERFLOW 
(2 EXPONENT UNDERFLOW 
CJ iF RESULT = 0, SET TOO aE ERED EOIN IVIOE 
Clit RESULT <0, SET TO1 OC FIXED-POINT OVERFLOW 
Ole RESULT >0, SET TO 2 C1 FLOATING-POINT DIVIDE 


LIF OVERFLOW, SET TO 3 (DD OPERATION 
ME UNCHANGED 


OO@ O8O00 





The divide (D) instruction algebraically divides the double word in the operand 1 register 
pair (dividend) by the fullword in operand 2 (divisor) and puts the result (quotient and 
remainder) in operand 1. 


Explicit Format: 


LABEL A OPERATION A OPERAND 





[symbol] | D r, d(x 2b.) 


Implicit Format: 





A OPERATION A 


OPERAND 


Operand 1 consists of an even-odd pair of contiguous registers, where the even-numbered 
register, since it is the lower numbered register, is specified as operand 1. Every time the 
even-numbered operand 1 is referenced in the D instruction, both registers are used. The 
dividend occupies the register pair as a doubleword value with the high order bit or bits as 
the sign value. Operand 2 must be either defined as a full word in main storage, or 
aligned on a full-word boundary. The resulting quotient occupies the odd-numbered 
register as a full-word value with its sign determined algebraically. The remainder 
occupies the even-numbered register, also as a full-word value with its sign the same as 
the dividend. If the values of the divisor and dividend cause the quotient to be larger than 
a 32-bit signed integer, a fixed-point divide program exception occurs, no division takes 
place, and the dividend remains unchanged. 
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To load a value (dividend) into an even-odd register pair, use the load multiple (LM) 
instruction (see 10.16). If the value (dividend) can be contained in one register, it must be 
loaded into the odd-numbered register only. This can be done through the use of the load 
(L), load register (LR), or load halfword (LH) instructions. The even-numbered register must 
be cleared before execution of the D instruction. 


Operational Considerations: 


=  Operand 1 consists of an even-odd pair of registers located in consecutive order in 
the processor. 
=  Operand 1 always references the even-numbered register. 
= ~=6 The dividend occupies both registers. After the D instruction is executed, the quotient 
occupies the odd-numbered register, and the remainder occupies the even-numbered 
register. 
=  #Operand 2 must be either defined as a full word or aligned on a full-word boundary. 
= If operand 1 does not reference an even-numbered register, a specification exception 
occurs. 
s The condition code remains unchanged. 
= Division by zero causes a fixed-point divide program exception. 
= @Any of the even-numbered general registers (0 thru 14) can be used as the operand 1 
register pair. 
Example: 
LABEL AOPERATIONA OPERAND 
] 10 16 
SR 6,6 
L 7, DIVIDEND 
D 6,DIVISOR 
DIVIDEND DC F'1685! 


DIVISOR DC Fiz 




















UP-8061 Rev. 3 SPERRY UNIVAC OS/3 10-29 
ASSEMBLER 





Registers 6 and 7 before execution of D instruction: 


Register 6 Register 7 


0000 | 0000} 0000 ; 0000 j 0000 , 0000 | 0000 ; 0000 {0000 , 0000 | 0000 | 0000 }0000 0110 100110101 


operand 1 












binary 
hex 





DIVISOR before and after execution of D instruction: 


0000! 0000 0000 , 0000 | 0000 ,0000 | 0000 ,;0010 
pte moe) 8 see 


Registers 6 and 7 after execution of D instruction: 






binary 
hex 





Register 6 Register 7 








sign bits sign bits 


ee 


0000 10000 | 0000 10000 | 0000 10000 | 0000 | 0001 {0000 , 0000 | 0000 10000 }0000 10011 [010011010 
see ae Le Olay ee Oe ela 


remainder quotient 













binary 
hex 











In this example, registers 6 and 7 are the operand 1 register pair and DIVISOR (operand 2) 
has been defined as a full word constant. First, the SR instruction clears register 6 to 
zeros. Since the full word in DIVIDEND can be contained in one register, it is loaded into 
register 7 (the odd-numbered register) through the use of the L instruction. Then, the 
register pair 6-7 is divided by the full word in DIVISOR. The resulting remainder occupies 
register 6 with a positive sign (the same as the dividend) and the resulting quotient 
occupies register 7 with a positive sign (determined algebraically). 





Example: 
LABEL AOPERATIONA OPERAND 
1 10 16 
LM 6,7,DIVIDEND 
D 6,DIVISOR 
DIVIDEND Dc Fil! 
DC F'l5' 


DIVISOR DC F'1966' 
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Registers 6 and 7 before execution of D instruction: 


Register 6 Register 7 


0000 10000 | 0000 10000 | 0000 ;0000 ]0000 10001 | 0000 10000 | 0000 ; 0000 {0000 | 0000 j00001 1111 
ree Ee eee 


operand 1 
















DIVISOR before and after execution of D instruction: 


0000 | 0000 |0000 10000 | 0000 ; 0011) 11410, 1000 
ea Soa) ef ee Ras 


Registers 6 and 7 after execution of D instruction: 






binary 
hex 





Register 6 Register 7 





sign bits sign bits 


ee _—a 
0000 | 0000 | 0100 , 0001 | 1000 , 1001 | 0011 ;1001 










0000 10000 |0000 ;0000 | 0000 |0001 [0011 | 1001 
i fe | ieee es Oe eee 


remainder quotient 








10—30 


binary 
hex 


binary 
hex 


In this example, the even-odd register pair is loaded with the contents of DIVIDEND. This 
is done through the LM instruction because the dividend cannot be contained in one 


register and has a value of +4,294,967,311 which is greater than 


+2,147,483,647 (23'—1) 
—2,147,483,648 (—231). 


The content of DIVISOR is then divided into the double-word value in the even-odd 
register pair. The resulting quotient with sign occupies the odd-numbered register and the 


resulting remainder with sign occupies the even-numbered register. 
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10.12. LOAD (L) 


General 
OBJECT 
OPCODE FORMAT | INST. 
TYPE LGTH. 


Possible Program Exceptions 


BM ADDRESSING @ PROTECTION 

(0 DATA (INVALID SIGN/DIGIT)| [J SIGNIFICANCE 

(J DECIMAL DiviDE MB SPECIFICATION: 

C] DECIMAL OVERFLOW NOT A FLOATING-POINT REGISTER 
OO execute OP 1 NOT ON HALF-WORD BOUNDARY 
( EXPONENT OVERFLOW OP 2 NOT ON HALF-WORD BOUNDARY 
(EXPONENT UNDERFLOW OP 2 NOT ON FULL-WORD BOUNDARY 
(J FIXED-POINT DIVIDE OP 2 NOT ON DOUBLE-WORD 


LJ FIXED-POINT OVERFLOW BOUNDARY 
C FLOATING-POINT DIVIDE OP 1 NOT EVEN NUMBERED REGISTER 


1 operation OP 1 NOT ODD NUMBERED REGISTER 
NONE 
















| MNeM. | Hex. (BYTES) 


Condition Codes 


Clif RESULT = 0,SET TOO 





Olir ResuLt <o, Set TO1 
Clit RESULT >O, SET TO 2 
CIF OVERFLOW, SET TO 3 
MB UNCHANGED 


OOO O8000 





The /oad (L) instruction places the full-word in operand 2 into the operand 1 register. 


Explicit Format: 






A OPERATION A OPERAND 


[symbol] r, d, (x, ,b,) 





Implicit Format: 









A OPERATION A 


OPERAND 





LABEL 





[symbol] P18 (x, ) 


Operational Considerations: 
= § Any of the general registers (0 through 15) can be used as operand 1. 


= Operand 2 must be either defined as a full word or aligned on a full-word boundary. 
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Example: 
LABEL AOPERATIONS OPERAND 
1 10 16 
L 4 ,XNUM 
Ds OF 
XNUM DC X' 60666918 ' 


Register 4 before execution of L instruction: 


0000 0000 | 0000 ; 0000 0010, 1111 1001 ; 1000 
ee eee 


XNUM before and after execution of L instruction: 


0000 ; 0000 | 0000 ; 0000 | 0000! 0000} 0001 | 1000 






binary (leftover data from 
hex previous program) 













binary 
Register 4 after execution of L instruction: 
0000 ; 0000 | 0000 | 0000 {0000 | 0000} 0001 | 1000 pwany 
hex 


eee ee ee 


In this example, XNUM is defined as a hexadecimal constant aligned on a full-word 
boundary and register 4 is the operand 1 register. The L instruction places the full word in 
operand 2 into register 4 replacing any leftover data in register 4 with the contents of 
XNUM. 
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10.13. LOAD (LR) 


General 


OBJECT 


Possible Program Exceptions 


(J ADDRESSING CD PROTECTION 











































OPCODE FORMAT | INST. 
TYPE LGTH (J DATA (INVALID SIGN/DIG!IT) | [J SIGNIFICANCE 
(avtes) || DJ DECIMAL DiviDE (C0 SPECIFICATION: 


DO DECIMAL OVERFLOW 

OO ExecuTE 

OC EXPONENT OVERFLOW 
0 ExPONENT UNDERFLOW 
CJ FIX€D-POINT DIVIDE 

C1 FIXED-POINT OVERFLOW 
[J FLOATING-POINT DIVIDE 
(DD OPERATION 


NOT A FLOATING-POINT REGISTER 

OP 1 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON FULL-WORD BOUNDARY 


OP 2 NOT ON DOUBLE-WORD 
BOUNDARY 


OP 1 NOT EVEN NUMBERED REGISTER 
OP 1 NOT ODD NUMBERED REGISTER 
NONE 


Condition Codes 


Clif RESULT = 0, SET TOO 
Clit RESULT <o, SET TO1 
Cir RESULT > 0, SET TO 2 
CJ IF OVERFLOW, SET TO 3 
BBEUNCHANGED 



















BOO OOOOO 





The /oad (LR) instruction places the contents of the operand 2 register into the operand 1 
register. 


Explicit and Implicit Format: 


LABEL A OPERATION A OPERAND 





Operational Considerations: 
us Any of the general registers (O through 15) can be used as operands 1 and 2. 


= The contents of the register specified by operand 2 (r.) are loaded into the register 
specified by operand 1 (r,). 


= The contents of the register specified by operand 2 (r.) remain unchanged. 
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Example: e 
LABEL AOPERAT1IONA OPERAND 
1 10 - 16 

tL 7, FINTOT 

L 5, SUBTOT 

LR 6,5 

LR 8,7 

A 5, INTERTOT 

AR 7,5 

CVD 5,SUBTOTP 

CVD 7,FINTOTP 
FINTOT DC F'5630' 
SUBTOT DC F'226' 
FINTOTP DS D 
SUBTOTP ODS D 
INTERTOT DC F'26' 





binary (leftover data from 
hex previous program) 








In this example, the full word is FINTOT (FINTOT represents final total) is loaded into 
register 7 and the full word is SUBTOT (SUBTOT represents subtotal) is loaded into 
register 5. Then the content of register 5 is loaded into register 6 and the content of 
register 7 is loaded into register 8 so it can be saved prior to the execution of the 
suceeding add instructions. Then the full word in INTERTOT is added to register 5 (now 
register 5 has the most-current subtotal). The content of register 5 is added to the content 
of register 7 (now register 7 has the most current final total). The first CVD instruction 
converts the binary number in register 5 to its decimal equivalent and puts the result into 
the doubleword in SUBTOTP. The second CVD instruction converts the binary number in 
register 7 to its decimal equivalent and puts the result into the doubleword in FINTOTP. 
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10.14. LOAD AND TEST (LTR) 


Possible Program Exceptions 
ee 
OPCODE FORMAT | INST. 
TYPE LGTH. 


[J ADDRESSING CJ PROTECTION . 
| Nem. |HEX.| (BYTES) 


(1 DATA (INVALID SIGN/DIGIT) | [J SIGNIFICANCE 
CZ DECIMAL Divide C] SPECIFICATION: 
puma fiz{ pe | 2 
Condition Codes 


[1 DECIMAL OVERFLOW NOT A FLOATING-POINT REGISTER 
Wir RESULT =0,SET TOO 








0 EXECUTE OP 1 NOT ON HALF-WORD BOUNDARY 
CJ EXPONENT OVERFLOW | OP 2 NOT ON HALF-WORD BOUNDARY 
CO EXPONENT UNDERFLOW OP 2 NOT ON FULL-WORD BOUNDARY 
(] FIXED-POINT DIVIDE OP 2 NOT ON DOUBLE-WORD 

(0 FIXED-POINT OVERFLOW BOUNDARY 

(J FLOATING-POINT DIVIDE OP 1 NOT EVEN NUMBERED REGISTER 
C opeRATION OP 1 NOT ODD NUMBERED REGISTER 

NONE 


Mir Resu_t <o, set To1 
Wir RESULT >0, SET TO2 
Cir OVERFLOW, SET TO 3 
[CO UNCHANGED 





BOO OOOO0 





The /oad and test (LTR) instruction places the contents of the operand 2 register into the 
operand 1 register. The value and sign of operand 2 determines the setting of the 
condition code. The actual testing of the condition code is done through the execution of 
another instruction. 


Explicit and Implicit Format: 






A OPERATION A OPERAND 


[symbol] 


If operand 2 = O, set to O. 

If operand 2 < O, set to 1. 

If operand 2 > O, set to 2. 
Usually, a conditional branch instruction tests the resulting condition code for an equal to 
zero, less than zero, or greater than zero condition. If the condition specified is met, a 
branch takes place accordingly. If not, the program continues processing with the 
following instruction. 
Operational Considerations: 


= § Any of the general registers (0 through 15) can be used as operands 1 and 2. 


2 It is your responsibility to test the condition code setting. 
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Example: 

LABEL AOPERATIONA OPERAND 
1 10 16 

L 6,=F'25! 

LTR 7,6 

BC 8,ERRTN 
ERRTN AP ERCNT,=P'1! 
ERCNT DC PL2'@' 


Register 7 before execution of LTR instruction: 


00001! 0000 | 0000 10000] 1010, 0000} 0000 ; 0000 
L150] co 0 sah we 


Register 6 before and after execution of LTR instruction: 


0000! 0000 | 0000 ;0000} 0000; 0000} 0001 | 1001 P 
binary 


Register 7 after execution of LTR instruction: 


0000! 0000 | 0000 ;0000} 0000! 0000 | 0001 | 1001 2 
binary 


In this example, a full word containing the decimal value 25 is loaded into register 6. 
Then, the LTR instruction loads the contents of register 6 into register 7. The condition 
code is set to 2, since the value of register 6 (operand 2) is greater than zero. The BC 
instruction tests for an equal to zero condition which is represented by the decimal value 8 
in operand 1. If an equal to condition existed, a branch to the instruction labeled ERRTN 
would take place. Since that condition does not exist, the program continues processing 
with the instruction immediately following the BC instruction. 











binary (leftover data from 
hex previous program) 
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10.15. LOAD HALF WORD (LH) 


















OPCODE OBJECT |) ADDRESSING W@ PROTECTION 
F T: 
aa Rene (1 DATA (INVALID SIGN/DIGIT) | [1] SIGNIFICANCE 


(0 DECIMAL DiviDE C0 SPECIFICATION: 
CZ DECIMAL OVERFLOW 
(] execute 


Condition Codes 


(J 1F RESULT = 0,SET TOO 
Clie RESULT <0, SET TO1 
Clif RESULT > 0, SET TO 2 
C)1F OVERFLOW, SET TO 3 
HE UNCHANGED 





NOT A FLOATING-POINT REGISTER 

OP 1 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON FULL-WORD BOUNDARY 


OP 2 NOT ON DOUBLE-WORD 
BOUNDARY 


OP 1 NOT EVEN NUMBERED REGISTER 
OP 1 NOT ODD NUMBERED REGISTER 
NONE 


OC EXPONENT OVERFLOW 
0 ExPONENT UNDERFLOW 
CO FIXED-POINT DIVIDE 

OO FIxXED-POINT OVERFLOW 
( FLOATING-POINT DIVIDE 
(] OPERATION 


OOO OOOO 





The /oad half word (LH) instruction places the half word in operand 2 into the operand 1 
register. 


Explicit Format: 






A OPERATION A OPERAND 


[symbol] r, d,(x,,b, ) 


Implicit Format: 






A OPERATION A OPERAND 


[symbol] 


Since registers only work in conjunction with full words, the half word in operand 2 is 
automatically expanded to 32 bits by propagating the sign bit through the 16 high order bit 
positions. Then, operand 2 is loaded into the operand 1 register. 

Operational Considerations: 


a Any of the general registers (0 through 15) can be used as operand 1. 


= Operand 2 must either be defined as a half word or aligned on a half-word boundary. 





UP-8061 Rev. 3 SPERRY UNIVAC OS/3 10—38 








ASSEMBLER 
Example: 
LABEL AOPERAT IONA OPERAND 
] 10 16 
LH 4 ,PRODUCT 
PRODUCT OC H'256' 


Register 4 before execution of LH instruction: 


0000 |0000 }0000 ,0000 | 0000 ; 1100 |0001 11010 
Petefefefetef ata 


PRODUCT before and after execution of LH instruction: 









binary (leftover data from 
hex previous program) 


before expansion 


I, 
0000 }0001 {0000 |0000 


cc _ 


TT PSM Ea 
1000010000 ;0000 ,0000 














after expansion 


Register 4 after execution of LH instruction: 


0000 ; 0000 |0000 ,0000 | 0000 ; 0001 |0000 10000 


in this example, the half word in PRODUCT is expanded temporarily to a 32-bit signed 
integer. Then the LH instructions loads the contents of PRODUCT (now a 32-bit signed 
integer) into register 4. 









binary 
hex 
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10.16. LOAD MULTIPLE (LM) 



















OPCODE | FORMAT Inst. || ADDRESSING Ml PROTECTION 
ayee | cee [] DATA (INVALID SIGN/DIGIT) | 1] SIGNIFICANCE 






(] DECIMAL DIVIDE (C SPECIFICATION: 

CJ DECIMAL OVERFLOW NOT A FLOATING-POINT REGISTER 

CJ Execute OP 1 NOT ON HALF-WORD BOUNDARY 
C0 EXPONENT OVERFLOW OP 2 NOT ON HALF-WORD BOUNDARY 
C1 EXPONENT UNDERFLOW OP 2 NOT ON FULL-WORD BOUNDARY 
CO FIXED-POINT DIVIDE OP 2 NOT ON DOUBLE-WORD 

OC FIXED-POINT OVERFLOW BOUNDARY 

C1 FLOATING-POINT DIVIDE OP 1 NOT EVEN NUMBERED REGISTER 
C orperation OP 1 NOT ODD NUMBERED REGISTER 


| MNEM. JHEX, (BYTES) 


Condition Codes 


Cl tf RESULT =0,SETTOO 
Dif RESULT <o,SETTO1 
Clif RESULT >O, SET TO 2 
CJ iF OVERFLOW, SET TO 3 
WE UNCHANGED 


O 
C 
0 
(=) 
O 
O 
O 
O 


NONE 





The /oad multiple (LM) instruction loads the contents of two or more consecutive registers 
(operands 1 and 3) with an equal number of consecutive full words in main storage 
(operand 2). 


& Explicit Format: 






A OPERATION A OPERAND 


[symbol] 


Implicit Format: 






A OPERATION A OPERAND 


[symbol] 


The operand 1 register is the first register loaded and the operand 3 register is the last 
register loaded. If operands 1 and 3 are not consecutive, any registers consecutive to the 
operand 1 register up to and including the operand 3 register also are included. If the 
address of the operand 3 register is less than the address of the operand 1 register, the 
register addresses wrap around from 15 to 0. The number of full words in main storage to 
be loaded is determined by the number of consecutive registers specified. The registers 
are loaded in ascending sequence starting with the operand 1 register up to and including 
the operand 3 register. The content of operand 2 is loaded into the registers beginning 
with the byte addressed by the operand 2 label and continuing with as many full words 
@ that are needed to fill the registers specified. 
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= Any of the general registers (O thru 15) can be used as operands 1 and 3. 
7 Operand 2 must either be defined as a full word or aligned on a full-word boundary. 
= §8If operand 2 does not reference the correct number of full words needed to fill all the 
registers, full words consecutive to the first full word specified by operand 2 are 
loaded into the registers until the operand 3 register is filled. 
= = When loading multiple registers, the wrap-around concept applies. 
7 If operand 1 and operand 3 reference the same register, only that register is loaded 
with the contents of the first full word of operand 2. 
Example: 
LABEL AOPERATIONA OPERAND 
| 10 16 
LM 5,7,VALI 
VALI DC F'lg' 
VAL2 DC F'2g' 
VAL3 DC F'3g! 


Registers 5, 6, and 7 before execution of LM instruction: 


Register 5 Register 6 


00001! 0000] 0000 | 0000 | 0000 | 0000 | 0000; 0000 1000 ; 0001 
Eee eee ei 


leftover data from previous program 























Register 7 


0000 | 0000 | 0000 | 0000 | 0000 ; 1100} 101010100 
Re eee 


leftover data from previous program 
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VAL1, VAL2, and VAL3 before and after execution of LM instruction: 


VAL1 VAL2 


0000 10000 | 0000 | 0000 | 0000 ; 0000 | 0000 | 1010 0000 10000 | 0000 10000 | 0000 | 0000 | 0001 ,0100 
eee eee Ts), caer es Ee eee 


VAL3 


0000 10000 | 0000 10000 | 0000 , 0000 {0001 ; 1110 


Registers 5, 6, and 7 after execution of LM instruction: 

















Register 5 


0000 |0000 | 0000 ; 0000 | 0000 ; 0000 | 0000 ; 1010 
ee Re ee a 


Register 6 


0000 |0000 | 0000 ; 0000 | 0000 ; 0000 }0001 ,0100 











Register 7 








0000 {0000 | 0000 ; 0000 | 0000 ; 0000 | 0001 11110 


Ree Te eeeS 


In this example, operands 1 and 3 specify that registers 5, 6, and 7 are to be loaded with 


three consecutive full words from main storage starting with the first full word at VAL1 
(operand 2) and continuing until register 7 is filled. 
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Example: 

LABEL AOPERATIONA OPERAND 
1 10 16 

LM 5,5,TAGI 

DS OF 
TAG] dC XL2'6661' 
TAG2 DC XL2'3CQF'! 
TAG3 DC XL2'QGCA' 


Register 5 before execution of LM instruction: 


0000 | 0000 | 0000 , 0000 | 0000 ; 0000 | 0000 ; 0000 


TAG1, TAG2, TAG3 before and after execution of LM instruction: 






binary 
hex 





TAG1 TAG2 TAG3 remaining main storage 


eR I ON a RR Ty aT 
0000 10000 |0000 10001 }0011 ; 1100 |}0000; 1111} 0000 ; 0000 | 1 100 | 1070 | 0000 ; 0000 0000! 0000 
Ree Eke Ree 


full-word full-word 
boundary boundary 







Register 5 after execution of LM instruction: 


0000 10000 | 0000 ;0001 011 | 1100 [oo00 11111 
Pebefete[atefete] 


In this example, operand 1 and operand 3 both refer to register 5. Therefore, the content 
of operand 2 is loaded into register 5 (operand 1) beginning with the first byte at TAG1 
and continuing with as many full words that are needed to fill register 5 (operand 3). Note 
that only register 5 is filled with the first full word at operand 2. 






binary 
hex 
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Example: 

LABEL AOPERATIONA OPERAND 
] 10 16 

LM 14,2,SECTOR 
SECTOR DC BrE250" 

DC F' SDD ' 

DC F'2306' 

DC F'1690' 

DC F'62606' 


Registers before execution of LM instruction: 


Register 14 Register 15 


0000 ; 0000 | 0000; 0000} 0000 | 0000 | 0000 , 0000 0000 , 0000 | 0000 , 0000 0000 ,0000 | 0000 ,0000 


operand 1 
















Register 0 Register 1 


0000 , 0000 } 0000 | 0000 } 0000 ;0000 } 0000 ;0000 0000! 0000 0000 | 0000 | 0000 10000 | 0000 ;0000 


Register 2 


0000 ; 0000 | 0000 : 0000 | 0000 10000 | 0000 ,0000 


Operand 3 





















SECTOR before and after execution of LM instruction: 


0000 | 0000] 0000 ; 0000 /0000 ;0100 |1110,;0010 0000 10000 {0000 ;0000 {0000, 1114 1070 (0000 














binary 
0000 ,0011 ]1110 11000 ; 
binary 






hex 


UP-8061 Rev. 3 








Registers after execution of LM instruction: 


Register 14 


0000 | 0000 | 0000 0000 | 0000 10100; 111010010 
Reine 


Register 0 


0000 ; 0000 | 0000 ; 0000 | 0000 ; 1000 | 111111100 










SPERRY UNIVAC OS/3 
ASSEMBLER 





Register 15 


0000 ; 0000 | 0000 | 0000 ; 00001 1111 | 1010); 0000 
ee eae Lae 


Register 1 


0000 | 0000 |0000 |0000 | 000010011 | 1110! 1000 













Register 2 


ee a © 
0000 | 0000 | 0000 10000 | 0001 11000 }00111! 1000 


In this example, register 14 is the first register loaded and register 2 is the last register 
loaded. Since the address of operand 2, (register 2) is less than the address of operand 1 
(register 14), the register addresses wrap around from 15 to O up to and including 2. 
Operand 2 is either defined as a full word or aligned on a full-word boundary. The 
contents of operand 2 is loaded into register 14 starting with the byte addressed by 
SECTOR and continuing with as many full words until register 2 is filled. 





Remember that most !/O operations use registers 14, 15, 0, and 1. So, if you use these 
registers and then perform some input or output in your program, the original contents of 
these registers are destroyed. However, you can use these registers if you save the 
contents prior to every I/O operation, and restore them after completing each !/O 
operation. 


It may be helpful to note that the Supervisor usually uses the lower numbered registers 
and Data Management usually uses the higher numbered registers. 
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10.17. MULTIPLY (M) 














OBJECT |] gy ADDRESSING 








OPCODE | FORMAT 
TYPE 
| minem. | Hex, 


Condition Codes 


iNST. 
enc: (J DATA (INVALID SIGN/DIGIT) 
(Bytes) || (J DECIMAL DivIDE 


LC DECIMAL OVERFLOW 
OO execute 

OC EXPONENT OVERFLOW 
OO EXPONENT UNDERFLOW 
CO FIXED-POINT DIVIDE 


Possible Program Exceptions 


WE PROTECTION 
CO SIGNIFICANCE 
CD SPECIFICATION: 


10—45 


NOT A FLOATING-POINT REGISTER ° 
OP 1 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON FULL-WORD BOUNDARY 
OP 2 NOT ON DOUBLE-WORD 















OF RESULT = 0,SET TOO 
OF RESULT <0, SET TO 1 
(ie RESULT >0O, SET TO 2 
CF OVERFLOW, SET TO3 
fEUNCHANGED 


BOUNDARY 

OP 1 NOT EVEN NUMBERED REGISTER 

OP 1 NOT ODD NUMBERED REGISTER 
NONE 


OO FIXED-POINT OVERFLOW 
0 FLOATING-POINT DIVIDE 
(CD OPERATION 







OOg O@8000 


The multiply (M) instruction algebraically multiplies the operand 1 register pair by the full 
word in operand 2. The result replaces the operand 1 register. pair. 


Explicit Format: 








LABEL A OPERATION A OPERAND 


[symbol] 


Implicit Format: 


LABEL A OPERATION A 


OPERAND 





[symbol] | M 


Operand 1 must be a contiguous pair of even-odd registers. The even-numbered register, 
since it is lower numbered register, is specified as operand 1. Both the multiplier (operand 
2) and the multiplicand (operand 1) are 32-bit signed integers but the product is always a 
64-bit signed integer. Before execution of the M instruction, the multiplicand must be 
loaded into the odd-numbered register, while the content of the even-numbered register is 
ignored. The multiplier must either be defined as a full word or aligned on a full-word 
boundary. After execution of the M instruction, the resulting product replaces the even- 
odd register pair as a double-word value with the high order bits or bit as the sign value. 
The sign of the product is determined algebraically; like signs produce positive results and 
unlike signs produce negative results. If the product is always contained in the odd- 
numbered register, you can ignore the contents of the even-numbered register and store 
the contents of the odd-numbered register as the product. 
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Operational Considerations: @ 
= Operand 1 consists of an even-odd pair of registers located in consecutive order in 
the processor. 
= Operand 1 always references the even-numbered register. 
= The multiplicand occupies the odd-numbered register as a full-word value. 
= After the M instruction is executed, the product occupies both registers as a 
doubleword value. 
= Operand 2 must either be defined as a full word or aligned on a full-word boundary. 
= §@8©Any of the even-numbered genera! registers (O thru 14) can be used as operand 1. 
Example: 
LABEL AOPERATIONA OPERAND 
1 10 16 
L 5, MULTCAND 
M 4 ,MULTPLYR 
MULTCAND DC F' 244! 
MULTPLYR DC F'22' 


Registers 4 and 5 before execution of M instruction: 


Register 4 Register 5 


hex 


0000 | 0000 | 0000 | 0000} 0000 ; 0000 | 0000 , 0000} 0000 ;0000 0000} 0000 0000 '0000 1111110109] si 
inary 





operand 1 


MULTPLYR before and after execution of M instruction: 


0000 | 0000 |0000 | 0000} 0000 ,0000 /0001 {0110 










binary 
hex 
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& Registers 4 and 5 after execution of M instruction: 


Register 4 Register 5 


0000 | 0000 |0000 ;0000 | 0000 | 0000 | 0000 ,0000 0000 Jo000 |oo00 000 0001 ;0100 11411 11000] 
Bn ni ES meee 


operand 1 












binary 
hex 





In this example, the full-word value in MULTCAND is loaded into register 5 (odd-numbered 
register). Then, the full-word value in MULTPLYR is multiplied by register 4 (the even-odd 
register pair). The even-numbered register is ignored and the content of the odd-numbered 
register (in this case, 5) is used in the multiplication. 


The resulting product replaces the even-odd register pair as a double-word value. Since 
the value of this product is less than +2,147,483,647, it can be contained in register 5 
and register 4 can be ignored. 





Example: 
LABEL AOQPERATIONA OPERAND 
@ l 10 16 
L 7 ,MULTCAND 
M 6,MULTPLYR 
ST 7, HOLDAREA 
MULTCAND DC F'356' 
MULTPLYR DC Ff=54 
HOLDAREA DS F 


Registers 6 and 7 before execution of M instruction: 


Register 6 Register 7 


0000 |0000 0000 ; 0000 | 0000 0000 | 0000 ; 0000 | 0000 ,;0000 | 0000 , 0000 ; 0000 ; 0001 for01 11110) 


operand 1 











binary 
hex 
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MULTPLYR before and after execution of M instruction: 





sign bits 


1111 ,1111 Dit one 1111141111 41011 
Re cuenta ee 


(-5 in twos complement form) 











Registers 6 and 7 after execution of M instruction: 


sign bits 
















111141111 


binary 
hex 


Petefeteletel tel 


(-1750 in twos complement form) 





Prete telete 
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ST 


10.18. STORE (ST) 






Possible Program Exceptions 
























OPCODE ‘ =" ADDRESSING Mi PROTECTION 
ji rvee pane (1 DATA (INVALID SIGN/DIGIT)| LJ SIGNIFICANCE 
(Bytes) || J DECIMAL DIVIDE (] sPeciFICATION: 






OC DECIMAL OVERFLOW 

OJ execute 

(0 EXPONENT OVERFLOW 
DD ExPONENT UNDERFLOW 
(1 FIXED-POINT DIVIDE 

O FIXED-POINT OVERFLOW 
CO FLOATING-POINT DIVIDE 
(1 OPERATION 


NOT A FLOATING-POINT REGISTER 

OP 1 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON FULL-WORD BOUNDARY 


OP 2 NOT ON DOUBLE-WORD 
BOUNDARY 


OP 1 NOT EVEN NUMBERED REGISTER 
OP 1 NOT ODD NUMBERED REGISTER 
NONE 


Condition Codes 


Clif RESULT = 0,SETTOO 
Cltrt RESULT <0, SET TO1 
OllF RESULT >0, SET TO 2 
CF OVERFLOW, SET TO 3 
BEUNCHANGED 


NOOO Ow8ooO0 





The store (ST) instruction places the contents of the operand 1 register unchanged into the 
full word in operand 2. 


Explicit Format: 







A OPERATION A OPERAND 





[symbol] rd, (x, -b5) 


Implicit Format: 









A OPERATION A OPERAND 


[symbol] 


Operational Considerations: 
= §6Any of the general registers (0 through 15) can be used as operand 1. 
= Operand 2 must either be defined as a full word or aligned on a full-word boundary. 


= Unlike most instructions, the ST instruction has operand 1 as the sending field and 
operand 2 as the receiving field. 
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Example: 
LABEL AOPERATIONA OPERAND 
] 10 16 
L 7 ,=F'25' 
ST 7, CHART+4 
CHART DC F'22! 
DC F'Sg' 
DC F'28! 


CHART+4 before execution of ST instruction: 


0000 | 0000 | 0000 ; 0000 | 0000 , 0000 }0011 ,0010 
BRIE ERIS ees 
' 


Register 7 before and after execution of ST instruction: 


0000 ; 0000 |0000 | 0000 | 0000 , 0000 | 0001 ; 1001 bi 
inary 


CHART-+4 after execution of ST instruction: 


0000 | 0000 |0000 | 0000 | 0000 ;0000 | 0001 | 1001 


In this example, register 7 is loaded with a full-word value of 25. Then the content of 
register 7 destroys the content of the second full word in CHART and replaces it with the 
content of register 7. 






binary 
hex 















binary 
hex 
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STH 


10.19. STORE HALF WORD (STH) 


Possible Program Exceptions 


IB ADDRESSING @ PROTECTION 

(DATA (INVALID SIGN/DIGIT) | [) SIGNIFICANCE 

(J DECIMAL DIVIDE (0 SPECIFICATION: 

(1 DECIMAL OVERFLOW NOT A FLOATING-POINT REGISTER 
0 ExecuTE OP 1 NOT ON HALF-WORD BOUNDARY 
(EXPONENT OVERFLOW OP 2 NOT ON HALF-WORD BOUNDARY 
(1 EXPONENT UNDERFLOW OP 2 NOT ON FULL-WORD BOUNDARY 
OO FIXED-POINT DIVIDE OP 2 NOT ON DOUBLE-WORD 

OD FIXED-POINT OVERFLOW BOUNDARY 

C] FLOATING-POINT DIVIDE OP 1 NOT EVEN NUMBERED REGISTER 
(J OPERATION OP 1 NOT ODD NUMBERED REGISTER 
NONE 


OBJECT 
OPCODE FORMAT | INST. 


LGTH. 
(BYTES) 


Condition Codes 


Clif RESULT = 0, SET TOO 
Olir RESULT <0,SETTO1 
Cir RESULT > 0, SET TO 2 
(iF OVERFLOW, SET TO 3 
BB UNCHANGED 









DOO OOsB8D0 





The store half word (STH) instruction places bits 16 through 31 of the operand 1 register 
unchanged into the half word in operand 2. 


Explicit Format: 






A OPERATION A OPERAND 


[symbol] 


Implicit Format: 


LABEL A OPERATION A OPERAND 


[symbol] | STH 





Operational Considerations: 
= Any of the general registers (0 through 15) can be used as operand 1. 
= Operand 2 must be either defined as a half word or aligned on a half-word boundary. 


= Unlike most instructions, the STH instruction has operand 1 as the sending field and 
operand 2 as the receiving field. 
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Example: 

LABEL AOPERATIONA OPERAND 
1 10 16 

LA 7 ,HALFBUF 

LH 6,=H'43! 

CH 6, CONSTANT 

BNE ERROR 
ERROR STH 6,6(7) 

A 7,=F'2! 
CONSTANT DC H'S! 

DS OH 
HALFBUF DS CL8¢ 


HALFBUF (2) before execution of STH instruction: 







0000 | 0000 | 00000001 


Petefete 


Register 6 before and after execution of STH instruction: 


0000 1 0000 | 0000 ; 0000 | 0000 ; 0000 /0010 11011 
Re ees 


ere 
Bits 16 — 31 


binary (leftover data from 
hex previous program) 









binary 
hex 





HALFBUF (2) after execution of STH instruction: 


0000 10000 }00101 1011 : 
binary 


hex 


o! o 21 8B 





In this example, the address of HALFBUF is loaded into register 7, and the half-word 
decimal value of 43 is loaded into register 6. Then, the content of register 6 is compared 
to the half-word decimal value in CONSTANT. Since the value 43 is less than 50, the 
condition code is set to 1 and the branch to the instruction labeled ERROR takes place. 
There, bits 16 through 31 of register 6 are stored in the first two bytes of HALFBUF. A full 
word of 2 is then added to the address in register 7 which increases the address by 2 
bytes. This makes it possible for the next unequal condition to be stored in the succeeding 
two bytes and so on. 
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STM 


10.20. STORE MULTIPLE (STM) 


OBJECT || gy ADDRESSING @ PROTECTION 
ae [J DATA (INVALID SIGN/DIGIT) | (J SIGNIFICANCE 
(Bytes) {| () DECIMAL DivIDE C SPECIFICATION: 

[) DECIMAL OVERFLOW NOT A FLOATING-POINT REGISTER 
OC execute OP 1 NOT ON HALF-WORD BOUNDARY 
[EXPONENT OVERFLOW OP 2 NOT ON HALF-WORD BOUNDARY 
CO) ExPONENT UNDERFLOW OP 2 NOT ON FULL-WORD BOUNDARY 
CO FIXED-POINT DIVIDE OP 2 NOT ON DOUBLE-WORD 
C FIXED-POINT OVERFLOW BOUNDARY 
C1 FLOATING-POINT DIVIDE OP 1 NOT EVEN NUMBERED REGISTER 
CO] opeRATION OP 1 NOT ODD NUMBERED REGISTER 
NONE 





































OPCODE | FORMAT 
TYPE 









| MNEM. | HEX, 


Condition Codes 


CJ iF RESULT = 0, SET TOO 
Dif RESULT <0, SET TO 1 
Clit RESULT >0, SET TO 2 
OF ovERFLOW, SET TO 3 
BB UNCHANGED 










OOO Oe@ooo0 


The store multiple (STM) instruction places the contents of two or more consecutive 
registers (operands 1 and 3) into an equal number of consecutive full words in main 
storage (operand 2). 


Explicit Format: 






A OPERATION A OPERAND 







[symbol] d, (b,) 


ryt, 


Implicit Format: 







A OPERATION A OPERAND 


[symbol] 


The operand 1 register is the first register stored and the operand 3 register is the last 
register stored. If operands 1 and 3 are not consecutive, any registers consecutive to the 
operand 1 register up to and including the operand 3 register are also included. If the 
address of the operand 3 register is less than the address of the operand 1 register, the 
register addresses wrap around from 15 to O. The contents of the registers are stored in 
ascending sequence into an equal number of consecutive full words in main storage 
starting with the byte addressed by the operand 2 label, and continuing with as many full 
words that are needed to receive the contents of the registers specified. 
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Operational Considerations: 








= Any of the genera! registers (O through 15) can be used as operand 1 and operand 3. 
= Operand 2 must be defined as a full word or aligned on a full-word boundary. 
= If operand 2 does not reference the correct number of full words needed to receive 
the contents of all the registers specified, full words consecutive to the first full word 
specified by operand 2 are filled until the contents of the operand 3 register has been 
stored. 
= When storing multiple registers, the wraparound concept applies. 
= If operand 1 and operand 3 reference the same register, only the contents of that 
register is stored in the first full word of operand 2. 
Example: 
LABEL AQPERATIONA OPERAND 
1 10 16 
ZAP DWORD ,=P'525' 
CVB 5, DWORD 
M 4 ,MULTPLYR 
STM 4 5, DWORD 
DWORD DS D 
MULTPLYR DC F'26! 


DWORD before execution of STM instruction: 


Packed 


number 


Registers 4 and 5 before and after execution of STM instruction: 


Register 4 Register 5 


0000 1 0000 | 0000 | 0000] 0000 | C000 | 0000 | 0000 | 0000 | 0000 | 0000 ; 0000 | 00110107) 01011 0010 
















binary 
(decimal 
a a +13,650) 





Operand 1 operand 3 
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@ DWORD after execution of STM instruction: 


0000 10000 | 0000 | 0000 | 0000 | 0000 | 0000 | 0000 | 0000 | 0000 | 0000; 0000 | 0011 ,0101| 010110010 binary 
in 


In this example, the packed decimal number 525 is added to DWORD, which was 
previously cleared to zero. Then, the double word in DWORD is converted into its binary 
equivalent and the result is placed in register 5. The contents of registers 4 and 5 are then 
multiplied by the full word in MULTPLYR and the result replaces registers 4 and 5 as a 
double-word value. Register 4 (operand 1) and register 5 (operand 3) are stored in the first 
two full words in DWORD. 
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S 


10.21. SUBTRACT (S) 


General 





























Shean OBJECT |) my ADDRESSING 
FORMAT | INST. 
N/DIGIT 
VBE POE: 0 DATA (INVALID SIGN/DIGIT) 


(J DECIMAL DIVIDE 

C1 DECIMAL OVERFLOW 

OO Execute 

C] EXPONENT OVERFLOW 
0 ExPONENT UNDERFLOW 
CJ FIXED-POINT DIVIDE 

® FixED-POINT OVERFLOW 


MNEM. JHEX, (BYTES) 


Condition Codes 


Mir RESULT = 0,SETTOO 
Mir Resu_t <o, set To1 


Possible Program Exceptions 


BB PROTECTION 
() SIGNIFICANCE 
CO SPECIFICATION: 


NOT A FLOATING-POINT REGISTER 

OP 1 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON FULL-WORD BOUNDARY 


OP 2 NOT ON DOUBLE-WORD 
BOUNDARY 


OP 1 NOT EVEN NUMBERED REGISTER 










C0 FLOATING-POINT DIVIDE 
CJ OPERATION 


BB if RESULT >0O, SET TO 2 
@ ir OVERFLOW, SETTO3 
(J UNCHANGED 











OP 1 NOT ODD NUMBERED REGISTER 


OOO OM8O000 


2 
O° 
2 
m 


The subtract (S) instruction subtracts the contents of the full word in operand 2 from the 
contents of the operand 1 register. The difference replaces the operand 1 register. 


Explicit Format: 








A OPERATION A OPERAND 


[symbol] 


Implicit Format: 


LABEL 


A OPERATION A OPERAND 


[symbol] cS r,s (x_) 
12.2 








When the actual subtraction takes place, the twos complement form of operand 2 is added 
to operand 1. The sign of the result is determined algebraically. 


Operational Considerations: 
= ~=6Any of the genera! registers (0 through 15) can be used as operand 1. 


= = =©Operand 2 must be either defined as a full word or aligned on a full-word boundary. 
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e Example: 
LABEL AOPERATIONA OPERAND 
] 10 16 
L 5,=F'52!' 
Ss 5 , VALUE 
VALUE Dc F'li' 


Register 5 before execution of S instruction: 









0000 1 0000 | 0000 10000 | 0000 | 0000 | 0000 | 1011 















binary 
e eee | ee) ee eed “Pe 
Register 5 after execution of S instruction: 
000010000 |0000 10000 |0000 10000 }000010000) 5... 
hex 


ESE ee 
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SR 


10.22. SUBTRACT (SR) 


Possible Program Exceptions 


[J] ADDRESSING (] PROTECTION 

[J DATA (INVALID SIGN/DIGIT)| [] SIGNIFICANCE 

(1 DECIMAL DIVIDE TC SPECIFICATION: 

CD) DECIMAL OVERFLOW NOT A FLOATING-POINT REGISTER 
OO execute OP 1 NOT ON HALF-WORD BOUNDARY 
(C1 EXPONENT OVERFLOW OP 2 NOT ON HALF-WORD BOUNDARY 
C) EXPONENT UNDERFLOW OP 2 NOT ON FULL-WORD BOUNDARY 
C] FIX€D-POINT DIVIDE OP 2 NOT ON DOUBLE-WORD 


@ FIxXeD-POINT OVERFLOW BOUNDARY 
( FLOATING-POINT DIVIDE OP 1 NOT EVEN NUMBERED REGISTER 


(J OPERATION OP 1 NOT ODD NUMBERED REGISTER 
NONE 























OBJECT 
OPCODE FORMAT | INST. 
TYPE LGTH. 





HEX. (BYTES) 
Condition Codes 


@ iF RESULT =0,SET TOO 













Wir RESULT <o, SET TO1 
Wie RESULT > 0, SET TO 2 
BB if OVERFLOW, SET TO 3 
(J UNCHANGED 


OOO OOOOO 





The subtract (SR) instruction subtracts the contents of the operand 2 register from the 
contents of the operand 1 register and places the difference in the operand 1 register. 


Explicit and Implicit Format: 





A OPERATION A OPERAND 


When the actual subtraction takes place, the twos complement form of operand 2 is added 
to operand 1. The sign of the result is determined algebraically. 


Operational Considerations: 
= Any of the general registers can be used as operands 1 and 2. 


# This instruction can be used to clear a register by subtracting the content of the 
register from itself. 


= The subtraction is performed by converting the number in operand 2 (r,) into a signed 
twos complement binary number and then algebraically adding it to the value in 
operand 1 (r,). 


= The maximum fixed-point number that can be contained in a 32-bit register is 
2,147,483,647(23'—1); the minimum number is —2,147,483,648(—23'). For decimal 
numbers outside this range, an overflow condition is produced. 


= = =§=6The contents of operand 2 (r2) are not changed by the subtract (SR) instruction. 
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S$ Example: 

LABEL  AOPERATIONA OPERAND 
| 10 16 

LM 5 ,6,HRS 

SR 4k 

A 5 HRSOT 

M hy RATE 

SR 5,6 

ST 5 .FLWRD 
HRS oc Fihg! 
DEDUC ~~ OC F'2916! 
HRSOT DC F 43! 
RATE DC F'359! 
FLWRD _—ODS F 


Register 4 after execution of first SR instruction: 


0000 | 0000 | 0000 {0000] 0000 | 0000 }0000 ;0000 


Registers 4 and 5 before execution of second SR instruction: 


0000 ,0000 0000 }0000 0000 | 0000 |0000 ,0000 }0000 ,;0000 0000 ,0000 0011; 1010 | 1100 ,;1010 
coe |G Os OOS) Oh Se ee eae a 


Register 6 before and after execution of SR instruction: 


! 
0000 10000 }0000 ; 0000 | 0000 | 1011 |0110 ;0100 
nie Ieee 







binary 
hex 















binary 
hex 










binary 
hex 
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Registers 4 and 5 after execution of second SR instruction: 


0000 ;0000 0000 ;0000/] 0000 10000 }0000 |0000 0000 0000 0000 10000 | 0010) 1111 0110 {0101 
Ee Re eee 


In this example, two full words (starting with the byte addressed by HRS and including the 
full word in DEDUC) are loaded into registers 5 and 6. The SR instruction clears register 4 
to zeros and the content of HRSOT is added to the content of register 5. Register 5 now 
contains the standard 40 working hours per week plus any overtime hours. The content of 
RATE is multiplied by the even-odd register pair. The product replaces registers 4 and 5 as 
a double-word value. The content of register 6 is subtracted from register 5 (since the 
product is contained in one register) and the difference replaces register 5. Register 5 now 
contains one employee's weekly net pay. The content of register 5 is then stored in 
FLWRD in main storage. 






binary 
hex 
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SH 


10.23. SUBTRACT HALF WORD (SH) 


woe ADDRESSING @ PROTECTION 
1 DATA (INVALID SIGN/DIGIT)| [1 SIGNIFICANCE 

































OPCODE | FORMAT 















TYPE LGTH. 
(ayTes) |} D) DECIMAL DIVIDE OC SPECIFICATION: 
C1) DECIMAL OVERFLOW {] NOTA FLOATING-POINT REGISTER 
| sh fap] ax | 4 | CJ execute C] OP 1 NOT ON HALF-WORD BOUNDARY 
CL EXPONENT OVERFLOW Moo. 2. NOT ON HALF-WORD BOUNDARY 
CL) EXPONENT UNDERFLOW Cl oP 2 NOT ON FULL-WORD BOUNDARY 
Mivnsucteaccrsac CO FIXED-POINT DIVIDE C1 op 2NOT ON DOUBLE-woRD 
Wie Resuct <o, set T01 Bi FixeD-POINT OVERFLOW g BOUNDARY 
WEF RESULT >0, SET TO2 LJ FLOATING-POINT DIVIDE OP 1 NOT EVEN NUMBERED REGISTER 
MF OVERFLOW, SET TO3 [1] OPERATION LI oP 1 NOT ODD NUMBERED REGISTER 
(UNCHANGED C) None 


The subtract half word (SH) instruction subtracts the contents of the half word in operand 
2 from the contents of the operand 1 register. The difference replaces the operand 1 
register. 


Explicit Format: 






A OPERATION A OPERAND 





[symbol] r, d, (x, bo) 


Implicit Format: 







AOPERATION A OPERAND 


[symbol] 


Operand 2 is two bytes in length (a 16-bit signed integer) and is located in main storage. 
Before operand 2 is subtracted from operand 1, operand 2 is temporarily expanded to 32 
bits by propagating the sign bit through the high order 16 bit positions. Then the twos 
complement of operand 2 is added to operand 1. The difference replaces the content of the 
operand 1 register. 
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Operational Considerations: 





= Any of the general registers (0 through 15) can be used as operand 1. 
#  Operand 2 must either be defined as a half word or aligned on a half-word boundary. 
= 6A fixed-point overflow condition can occur. 


= Execution of the SH instruction sets the condition code accordingly. 





Example: 
LABEL AOPERATIONA OPERAND 
1 10 16 
LA 5,2 
L 9,BADACTS 
CH 5,CODECD 
BE GDACTS 
GDACTS SH 9, VALUE] 
ST 9,YTDACTS 
CODECD OC H'2! 
BADACTS DC F'3! 
VALUE | DC H'1! 
YTDACTS 0S F 


Register 9 before execution of SH instruction: 


0000 10000 | 0000 10000 | 0000 ;0000 {0000 10011 


VALUE1 before and after execution of SH instruction: 






binary 
hex 





before expansion 
Pe ee 


0000 |0000 | 0000 ;0000 | 0000 ;0000 |0000 10001 


after expansion 












UP-8061 Rev. 3 SPERRY UNIVAC OS/3 10—63 
ASSEMBLER 





Register 9 after execution of SH instruction: 


0000 [0000 | 0000 ;0000| 0000 }0000 | 0000 10010 


In this example, the decimal value 2 is loaded into register 5 and the content of BADACTS 
is loaded into register 9. Then the content of register 5 is compared to the half-word value 
of CODECD. Since an equal to condition exists, the condition code is set to 0. As a result, 
the following branch to the instruction labeled GDACTS takes place. There, the half word 
in VALUE1 is expanded to a 32-bit signed integer, and the twos complement form of 
VALUE1 is added to register 9. The difference occupies register 9 as a full-word value. 
Finally, the ST instruction stores the contents of register 9 in YTDACTS located in main 
storage. 











binary 
hex 
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11. Floating-Point Instructions 


11.1. INTRODUCTION 


The floating-point instruction set is added to the instruction repertoire as part of the 
floating-point control feature. An operation exception results if a floating-point instruction 
is issued to a processor in which the floating-point control feature has not been installed. 


The floating-point instruction set provides for loading, adding, subtracting, comparing, 
multiplying, dividing, storing, and sign control of short or long format floating-point 
operands. Four double-word floating-point registers are provided to accommodate storing 
and loading of results and operands. These registers are numbered O, 2, 4, and 6. The 
specification of any other register number results in a specification exception. For long 
format operands, the entire double-word register is involved in the operation. For short 
format operands, excluding the product in the short format multiple (ME) instruction, only 
the most significant word of the double-word register is involved in the operation. The 
least significant word remains unchanged. Separate instructions are provided for 
operations with long and short format operands. 


Each operand is treated as a floating-point number consisting of a biased exponent 
(characteristic) and a signed fraction (mantissa). The biased exponent is expressed in 
excess—64 binary notation; the fraction is expressed as a hexadecimal number having an 
arithmetic point to the left of the high-order digit. The quantity expressed by the full 
floating-point number is the product of the fraction and the number 16 raised to the power 
of the biased exponent minus 64 (fraction times 16°~®*). 


A quantity may be represented with the greatest precision by a floating-point number of a 
given fraction length when the number is in a “normalized” form. A normalized floating- 
point number has a nonzero, high-order hexadecimal fraction digit. 


An exponent overflow exception develops if, in the result of a floating-point instruction, 
the characteristic of the result exceeds 127 and the fraction of the result is not zero. An 
exponent underflow exception develops if the characteristic is less than zero and the 
fraction of the result is not zero. An exponent overflow exception causes a program 
interruption. An exponent underflow exception causes a program interruption if the 
exponent underflow mask bit of the current PSW is 1. 


A floating-point number having a zero characteristic, a zero fraction, and a positive (zero) 
sign is said to be a “true zero” number. 


UP-8061 Rev. 3 SPERRY UNIVAC OS/3 
ASSEMBLER 


The floating-point instructions are available in RR and RX formats. Therefore, at least one 
of the operands is contained in one of the floating-point registers. The other operand is 
located in the same or another register or in main storage. Each main storage address 
may be specified as relative or absolute. 


To increase the precision of certain computations, an additional least significant digit, the 
guard digit, is carried within the hardware in the intermediate result of the following 
operations: add-normalized, subtract-normalized, add-unnormalized, subtract- 
unnormalized, compare, halve, and multiply. In the execution of add-normalized, subtract- 
normalized, add-unnormalized, subtract-unnormalized, and compare instructions, when a 
right shift of the fraction is required to equalize two exponents, the last hexadecimal digit 
to be shifted out of the least significant digit position of the fraction is saved by the 
processor hardware as the guard digit. The shifted fraction, including the guard digit, is 
used in computing the intermediate result. In the halve instruction, the least significant bit 
position of the fraction is saved as the most significant bit position of the guard digit. In 
the long format multiply instruction, the guard digit is used in computing the intermediate 
result. In the halve instruction, the least significant bit position of the fraction is saved as 
the most significant bit position of the guard digit. In the long format multiply instruction, 
the guard digit is carried as the fifteenth digit of the fraction of the intermediate product. If 
the intermediate result is subsequently normalized, the guard digit is shifted left to 
become part of the normalized fraction. 


This section describes the operation of each floating-point instruction. The instructions are 
arranged in alphabetical order according to mnemonic operation code. Each description 
includes a list of the possible program exceptions and condition codes which may result. 
(See 2.1, 2.3, 2.6, 5.1, 5.2.12, Appendix C, and Appendix D.) 
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AD 


11.2. ADD NORMALIZED, LONG FORMAT (AD) 


General 


OBJECT 
OPCODE FORMAT | INST. 


Possible Program Exceptions 


fi ADDRESSING 

[J DATA (INVALID SIGN/DIGIT) 
(J DECIMAL DivIDE 

C] DECIMAL OVERFLOW 

OJ Execute 

BBEEXPONENT OVERFLOW 
WEEXPONENT UNDERFLOW 

CJ FIXED-POINT DIVIDE 

OU FIXED-POINT OVERFLOW 

DD FLOATING-POINT DIVIDE 

HE OPERATION 














WW PROTECTION 

BB SIGNIFICANCE 

OO SPECIFICATION: 

NOT A FLOATING-POINT REGISTER 
OP 1 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON FULL-WORD BOUNDARY 


OP 2 NOT ON DOUBLE-WORD 
BOUNDARY 


OP 1 NOT EVEN NUMBERED REGISTER 
OP 1 NOT ODD NUMBERED REGISTER 
NONE 











TYPE LGTH. 
MNEM. |HEX. (BYTES) 


Condition Codes 


M if RESULT = 0,SETTOO 













Mir Resuct <o, set To1 
@ if RESULT > 0, SET TO 2 
OJiF OVERFLOW, SET TO3 
[LI UNCHANGED 


OOO @OOOS8 





The add normalized, long format (AD) instruction causes the contents of the double word 
in storage specified by operand 2 to be algebraically added to the contents of the double- 
word register specified by operand 1 (r,). The sum is normalized and placed in the operand 
1 (r,) register. 


Explicit Format: 








A OPERATION A OPERAND 


[symbol] 
ADLONG 


rd, (x,,b,) 
R4,50(R7,R8) 


Implicit Format: 







A OPERATION A OPERAND 


[symbol] 


ADLONG R4,FAM 
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Operational Considerations: 


Floating-Point Addition 


Floating-point addition consists of exponent equalization and fraction addition. If the 
exponents are equal, the fractions are added to form an intermediate sum. If the 
exponents are unequal, the smaller exponent is subtracted from the larger. The 
difference indicates the number of hexadecimal digit shifts to the right to be 
performed on the fraction having the smaller exponent. Each hexadecimal digit shift 
to the right causes the exponent to be increased by 1. After equalization, the fractions 
are added to form an intermediate sum. 


A carry-over digit of the most significant hexadecimal digit position of the 
intermediate sum causes the intermediate sum to be shifted right one digit position 
and the exponent to be increased by 1. If an exponent overflow condition occurs, the 
resultant floating-point number consists of a normalized and correct fraction, a correct 
sign, and an exponent which is 128 less than the correct value. 


Normalization 


The intermediate sum is composed of 14 hexadecimal digits, a guard digit, and a 
possible carry-over digit. If any most signficant digits of the intermediate sum are 
zero, the fraction including the guard digit is shifted left to form a normalized fraction. 
Vacated least significant digit positions are zero filled, and the exponent is reduced by 
the number of shifts. If normalization is unnecessary, the guard digit is lost. 


Exponent Underflow 


If normalization causes the exponent to become less than zero, an exponent 
underflow condition results. If the exponent underflow mask bit (38) of the current 
program status word (PSW) is 1, the resultant floating-point number has a correct and 
normalized fraction, a correct sign, and an exponent which is 128 more than the 
current value. If the exponent underflow mask of the current PSW is zero, the result 
is a true zero. 


Zero Result 


If the intermediate sum, including the guard digit, is zero, a significance exception 
exists. If the significance mask bit (39) of the current PSW is 1, the result is not 
normalized and the exponent remains unchanged. If the significance mask bit of the 
current PSW is zero and the intermediate sum is zero, the result is made a true zero. 
Exponent underflow cannot occur for a zero fraction. 


The sign of an arithmetic result is determined algebraically. The sign of a result with 
a zero fraction is always positive. 
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Example: 
LABEL AOPERATIONA OPERAND 
1 10 16 
ADLONG AD R4, FAM 
FAM dC D'1gg' 


Before execution of the add normalized, long format (AD) instruction, if we assume a 
value of +50 in R4, the contents of R4 and storage area FAM will be: 


R4 before execution: 


eel sal Sey oom ee | eee eee 


FAM before and after execution: 
2 ae ATED Gee OO) OO [200] 04) Bet soi] lo 


R4 after execution: 


Eeee CERES eae eA ee 
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ADR 


11.3. ADD NORMALIZED, LONG FORMAT (ADR) 


Possible Program Exceptions 


oecee: | egauay ee [1] ADDRESSING C) PROTECTION 
VEE LGTH. (J DATA (INVALID SIGN/DIGIT) BB SIGNIFICANCE 
(BYTES) || DJ DECIMAL DIVIDE CI SPECIFICATION: 
1 DECIMAL OVERFLOW NOT A FLOATING-POINT REGISTER 
OC execute OP 1 NOT ON HALF-WORD BOUNDAE. ¥ 
OP 2 NOT ON HALF-WORD BOUNDAHY 
OP 2 NOT ON FULL-WOR™ BOUNDARY 


OP 2 NOT ON DOUBLE-WORD 

BOUNDARY 

OP 1 NOT EVEN NUMB¢ RED REGISTER 

oP 1 NOT ODD NUMBERED REGISTER 
NONE 


EXPONENT OVERFLOW 
Condition Codes @ EXPONENT UNDERFLOW 


MiluLcucrcouernoe DD FIXED-POINT DIVIDE 
Bir BESUL P< oO SER TON OD FIXED-POINT OVERFLOW 


@ir RESULT >0, SET TO 2 (J FLOATING-POINT DIVIDE 
CIF OVERFLOW, SET TO 3 @ OPERATION 
CLI UNCHANGED 


OOO OOOO 





The add normalized, long format (ADR) instruction causes the contents of the doubl :-word 
register specified by operand 2 (r,) to be algebraically added to the contents of the double- 
word register specified by operand 1 (r,). The sum is normalized and placed in the operand 
1 (r,) register. 





Explicit and implicit Format: 







A OPERATION A OPERAND 





[symbol] 


ADLONG R4,R6 


Operational Considerations: 
m §=Floating-Point Addition 


Floating-point addition consists of exponent equalization and fraction addition. If the 
exponents are equal, the fractions are added to form an intermediate sum. li the 
exponents are unequal, the smaller exponent is subtracted from the larger. The 
difference indicates the number of hexadecimal digit shifts to the right to be 
performed on the fraction having a smaller exponent. Each hexadecimal digit shift to 
the right causes the exponent to be increased by 1. After equalization, the fraction: 
are added to form an intermediate sum. 
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A carry-over digit of the most significant hexadecimal digit position of the 
intermediate sum causes the intermediate sum to be shifted right one digit position 
and the exponent to be increased by 1. If an exponent overflow condition occurs, the 
resultant floating-point number consists of a normalized and correct fraction, a correct 
sign, and an exponent which is 128 less than the correct value. 


Normalization 


The intermediate sum is composed of 14 hexadecimal digits, a guard digit, and a 
possible carry-over digit. If any most significant digits of the intermediate sum are 
zero, the fraction including the guard digit is shifted left to form a normalized fraction. 
Vacated least significant digit positions are zero filled, and the exponent is reduced by 
the number of shifts. If normalization is unnecessary, the guard digit is lost. 


Exponent Underflow 


If normalization causes the exponent to become less than zero, an exponent 
underflow condition results. If the exponent underflow mask bit (38) of the current 
program status word (PSW) is 1, the resultant floating-point number has a correct and 
normalized fraction, a correct sign, and an exponent which is 128 more than the 
correct value. If the exponent underflow mask of the current PSW is zero, the result is 
a true zero. 


Zero Result 


If the intermediate sum, including the guard digit, is zero, a significance exception 
exists. If the significance mask bit (39) of the current PSW is 1, the result is not 
normalized and the exponent remains unchanged. If the significance mask bit of the 
current PSW is zero and the intermediate sum is zero, the result is made a true zero. 
Exponent underflow cannot occur for a zero fraction. 


The sign of an arithmetic result is determined algebraically. The sign of a result with 
a zero fraction is always positive. 


Example: 





LABEL AOPERATIONA OPERAND 
| 10 16 
ADLONG ADR R4,R6 
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Before execution of the add normalized, long format (ADR) instruction, if we assume a @ 
value of +50 in R4 and +100 in R6, the contents of the R4 and R6 will be: 





R4 before execution: 


R6 before and after execution: 


2 | Oe ae aaa oe eee 


R4 after execution: 
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AE 


11.4. ADD NORMALIZED, SHORT FORMAT (AE) 


Possible Program Exceptions 


ADDRESSING 

(J DATA (INVALID SIGN/DIGIT) 
(J DECIMAL Div!IDE 

C2) DECIMAL OVERFLOW 

O execute 

W@W EXPONENT OVERFLOW 

Mi EXPONENT UNDERFLOW 

CO FIXED-POINT DIVIDE 

() FIXED-POINT OVERFLOW 

CL] FLOATING-POINT DIVIDE 

BB OPERATION 














OBJECT 
OPCODE FORMAT | INST. 


PROTECTION 

i SIGNIFICANCE 

SPECIFICATION: 

NOT A FLOATING-POINT REGISTER 
OP 1 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON FULL-WORD BOUNDARY 


OP 2 NOT ON DOUBLE-WORD 
BOUNDARY 


OP 1 NOT EVEN NUMBERED REGISTER 
OP 1 NOT ODD NUMBERED REGISTER 
NONE 












TYPE LGTH. 
HEX. (BYTES) 


Condition Codes 


WB iF RESULT = 0,SET TOO 
Wir RESULT <o, SET TO1 
Wir RESULT >O, SET TO 2 
CF OVERFLOW, SET TO 3 
() UNCHANGED 

















OOO O8O008 


The add normalized, short format (AE) instruction causes the contents of the full word in 
storage specified by operand 2 to be algebraically added to the contents of a full word in 


the register specified by operand 1 (r,). The sum is normalized and placed in the full word 
in the operand 1 (r,) register. 


Explicit Format: 







A OPERATION A OPERAND 


[symbol] 
ADSHORT 


r, do (x, by) 
R4,50(R7,R8) 


Implicit Format: 







AOPERATION A OPERAND 


[symbol 


ADSHORT R4,FAM 
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Operational Considerations: 


Floating-Point Addition 


Floating-point addition consists of exponent equalization and fraction addition. If the 
exponents are equal, the fractions are added to form an intermediate sum. If the 
exponents are unequal, the smaller exponent is subtracted from the larger. The 
difference indicates the number of hexadecimal digit shifts to the right to be 
performed on the fraction having the smaller exponent. Each hexadecimal digit shift 
to the right causes the exponent to be increased by 1. After equalization, the fractions 
are added to form an intermediate sum. 


A carry-over of the most significant hexadecimal digit position of the intermediate 
sum causes the intermediate sum to be shifted right one digit position and the 
exponent to be increased by 1. If an exponent overflow condition occurs, the resultant 
floating-point number consists of a normalized and correct fraction, a correct sign, 
and an exponent which is 128 less than the correct value. 


Normalization 


The intermediate sum is composed of six hexadecimal digits, a guard digit, and a 
possible carry-over digit. If any most significant digits of the intermediate sum are 
zero, the fraction including the guard digit is shifted left to form a normalized fraction. 
Vacated least significant digit positions are zero filled and the exponent is reduced by 
the number of shifts. If normalization is unnecessary, the guard digit is lost. 


Exponent Underflow 


If normalization causes the exponent to become less than zero, an exponent 
underflow condition results. If the exponent underflow mask bit (38) of the current 
program status word (PSW) is 1, the resultant floating-point number has a correct and 
normalized fraction, a correct sign, and an exponent which is 128 more than the 
correct value. If the exponent underflow mask of the current PSW is zero, the result is 
a true zero. 


Zero Result 


If the intermediate sum, including the guard digit, is zero, a significance exception 
exists. If the significance mask bit (39) of the current PSW is 1, the result is not 
normalized and the exponent remains unchanged. If the significance mask bit of the 
current PSW is zero and the intermediate sum is zero, the result is made a true zero. 
Exponent underflow cannot occur for a zero fraction. 


The sign of an arithmetic result is determined algebraically. The sign of a result with 
a zero fraction is always positive. 
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& Example: 





LABEL AOPERATIONA OPERAND 
1 10 16 

ADSHORT AE R4 FAM 

FAM DC E'1 06" 


Before execution of the add normalized, short format (AE) instruction, if we assume a 
value of +50 in R4, the contents of R4 and storage area FAM will be: 


R4 before execution: 
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AER 


11.5. ADD NORMALIZED, SHORT FORMAT (AER) 


Possible Program Exceptions 
OPCODE | FORMAT 
TYPE 
| mem. | Hex. | 























OBJECT 
INST. 
LGTH. 
(BYTES) 


() ADDRESSING CTC) PROTECTION 
(J DATA (INVALID SIGN/DIGIT) | Il SIGNIFICANCE 
(] DECIMAL DIVIDE (J SPECIFICATION: 

















CJ DECIMAL OVERFLOW ME NOTA FLOATING-POINT REGISTER 
| acer |3a| re | 2 | OC execute (11 OP 1 NOT ON HALF-WORD BOUNDARY 
@ EXPONENT OVERFLOW [1] oP 2 NOT ON HALF-WORD BOUNDARY 
WEXPONENT UNDERFLOW O oP. 2 NOT ON FULL-WORD BOUNDARY 
C1 FIXED-POINT DIVIDE Ol op 2 NOT ON DOUBLE-WOoRD 
ie sage einai C1 FIXED-POINT OVERFLOW g BOUNDARY 
Mie RESULT >O.SET tO? 1] FLOATING-POINT DIVIDE OP 1 NOT EVEN NUMBERED REGISTER 
(Cif OVERFLOW, SET TO3 W@ OPERATION QO) oP 1 NOT ODD NUMBERED REGISTER 
(UNCHANGED OO None 





The add normalized, short format (AER) instruction causes the contents of a full word in 
the register specified by operand 2 (r2) to be algebraically added to a full word in the 
register specified by operand 1 (r,). The sum is normalized and placed in the operand 1 (r,) 
register. 


Explicit and Implicit Format: 






A OPERATION A OPERAND 






[symbol] 


ADSHORT R2,R4 


Operational Considerations: 
# §=Floating-Point Addition 


Floating-point addition consists of exponent equalization and fraction addition. If the 
exponents are equal, the fractions are added to form an intermediate sum. If the 
exponents are unequal, the smaller exponent is subtracted from the larger. The 
difference indicates the number of hexadecimal digit shifts to the right to be 
performed on the fraction having the smaller exponent. Each hexadecimal digit shift 
to the right causes the exponent to be increased by 1. After equalization, the fractions 
are added to form an intermediate sum. 
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A carry-over digit of the most significant hexadecimal digit position of the 
intermediate sum causes the intermediate sum to be shifted right one digit position 
and the exponent to be increased by 1. If an exponent overflow condition occurs, the 
resultant floating-point number consists of a normalized and correct fraction, a correct 
sign, and an exponent which is 128 less than the correct value. 


® Normalization 


The intermediate sum is composed of six hexadecimal digits, a guard digit, and a 
possible carry-over digit. If any most significant digits of the intermediate sum are 
zero, the fraction including the guard digit is shifted left to form a normalized fraction. 
Vacated least significant digit positions are zero filled and the exponent is reduced by 
the number of shifts. If normalization is unnecessary, the guard digit is lost. 


a Exponent Underflow 


If normalization causes the exponent to become less than zero, an exponent 
underflow condition results. If the exponent underflow mask bit (38) of the current 
program status word (PSW) is 1, the resultant floating-point number has a correct and 
normalized fraction, a correct sign, and an exponent which is 128 more than the 
correct value. If the exponent underflow mask of the current PSW is zero, the result is 
a true zero. 


a Zero Result 


If the intermediate sum, including the guard digit, is zero, a significance exception 
exists. If the significance mask bit (39) of the current PSW is 1, the result is not 
normalized and the exponent remains unchanged. If the significance mask bit of the 
current PSW is zero and the intermediate sum is zero, the result is made a true zero. 
Exponent underflow cannot occur for a zero fraction. 


= ~The sign of an arithmetic result is determined algebraically. The sign of a result with 


a zero fraction is always positive. 


Example: 
LABEL AOPERATIONA OPERAND 
] 10 16 
a eae 
ADSHORT AER R2,R4 
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Before execution of the add normalized, short format (AER) instruction, if we assume 
a value of +50 in R2 and +100 in R4, contents of R2 and R4 will be: 


R2 before execution: 


+50 


R4 before and after execution: 


R2 after execution: 


+150 
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AU 


11.6. ADD UNNORMALIZED, SHORT FORMAT (AU) 


Possible Program Exceptions 


opcove | rormat hoo ADDRESSING M@ PROTECTION 
VBE cer (1 DATA (INVALID SIGN/DIGIT)} I SIGNIFICANCE 
(Bytes) || D) DECIMAL DIVIDE C0 sPeciFICATION: 
C1 DECIMAL OVERFLOW NOT A FLOATING-POINT REGISTER 


0 execute OP 1 NOT ON HALF-WORD BOUNDARY 


WEEXPONENT OVERFLOW OP 2 NOT ON HALF-WORD BOUNDARY 
Condition Codes ( ExPONENT UNDERFLOW 


OP 2 NOT ON FULL-WORD BOUNDARY 
Micaesucr eo Ser Tao C0 F1XED-POINT DIVIDE OP 2 NOT ON DOUBLE-WORD 

Wir Resuct <0, SET TO1 0 FIXED-POINT OVERFLOW BOUNDARY 

@ if RESULT >0o, SET TO2 CO FLOATING-POINT DIVIDE 


OP 1 NOT EVEN NUMBERED REGISTER 
| {F OVERFLOW, SET TO3 B OPERATION OP 1 NOT ODD NUMBERED REGISTER 
(UNCHANGED 


NONE 





a 
O 
O 
a 
O 
O 
O 
O 


The add unnormalized, short format (AU) instruction causes the contents of the full word 
in storage specified by operand 2 to be algebraically added to the contents of a full word in 
the register specified by operand 1 (r,). The sum is placed in the operand 1 (r,) register. 


Explicit Format: 







A OPERATION A OPERAND 


[symbol] 
ADSHORT 


r, d, (x,,b, ) 
R4,50(R7,R8) 


Implicit Format: 







A OPERATION A OPERAND 


[symbol] 


ADSHORT R4,FAM 


Operational Consideration: 


] The execution of the AU instruction is identical to the AE instruction (11.4) except 
that the sum is not normalized before being placed in operand 1. 





UP-8061 Rev. 3 SPERRY UNIVAC OS/3 11—16 





ASSEMBLER 
Example: 
LABEL AOPERATIONA OPERAND 
1 10 16 
ADSHORT AU R4, FAM 
FAM DC E'166' 


Before execution of the add unnormalized, short format (AU) instruction, if we assume 
a value of +900 in R4, the contents of R4 and main storage area FAM will be: 


R4 before execution: 


+900 


R4 after execution: 


+1000 
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AUR 


11.7. ADD UNNORMALIZED, SHORT FORMAT (AUR) 


Possible Program Exceptions 


( ADDRESSING CD PROTECTION 

(J DATA (INVALID SIGN/DIGIT) | I SIGNIFICANCE 

(J DECIMAL DiviDE CO SPECIFICATION: 

(1) DECIMAL OVERFLOW NOT A FLOATING-POINT REGISTER 

O execute OP 1 NOT ON HALF-WORD BOUNDARY 
WE EXPONENT OVERFLOW OP 2 NOT ON HALF-WORD BOUNDARY 
(1 EXPONENT UNDERFLOW OP 2 NOT ON FULL-WORD BOUNDARY 
OO FIX€D-POINT DIVIDE OP 2 NOT ON DOUBLE-WORD 

OC FIxXED-POINT OVERFLOW BOUNDARY 

C FLOATING-POINT DIVIDE OP 1 NOT EVEN NUMBERED REGISTER 
OPERATION OP 1 NOT ODD NUMBERED REGISTER 

NONE 





OBJECT 
OPCODE FORMAT | INST. 















TYPE LGTH. 
(BYTES) 


Condition Codes 


WM iF RESULT = 0,SET TOO 
Mir RESULT <0, SET TO1 
Wir RESULT > 0, SET TO 2 
(tF OVERFLOW, SET TO 3 
( UNCHANGED 



















OOO OOOO 


The add unnormalized, short format (AUR) instruction causes the contents of a full word in 
the register specified by operand 2 (r.) to be algebraically added to a full word in the 
register specified by operand 1 (r,). The sum is placed in the operand 1 (r,) register. 


Explicit and Implicit Format: 








A OPERATION A OPERAND 


[symbol] 


ADSHORT R2,R4 


Operational Consideration: 


= §=6The execution of the AUR instruction is identical to the AER instruction (11.5), except 
that the sum is not normalized before being placed in operand 1. 








Example: 
LABEL AOPERATIONA OPERAND 
| 10 16 
ADSHORT AUR R2,R4 
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Before execution of the add unnormalized, short format (AUR) instruction, if we 
assume a value of +900 in R2 and +100 in R4, the contents of R2 and R4 will be: 


R2 before execution: 


+900 


+1000 
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AW 


11.8. ADD UNNORMALIZED, LONG FORMAT (AW) 


a ae 
OPCODE FORMAT | INST. 
TYPE LGTH. 


; Possible Program Exceptions 


BE ADDRESSING W PROTECTION 
(C0 DATA (INVALID SIGN/DIGIT) | I SIGNIFICANCE 

(1 DECIMAL DiviIDE DC SPECIFICATION: 

0 DECIMAL OVERFLOW NOT A FLOATING-POINT REGISTER 

O execute OP 1 NOT ON HALF-WORD BOUNDARY 
@ EXPONENT OVERFLOW OP 2 NOT ON HALF-WORD BOUNDARY 
OO ExPONENT UNDERFLOW OP 2 NOT ON FULL-WORD BOUNDARY 
CO FIxED-POINT DIVIDE OP 2 NOT ON DOUBLE-WORD 

C] FIXED-POINT OVERFLOW BOUNDARY 

(C0 FLOATING-POINT DIVIDE OP 1 NOT EVEN NUMBERED REGISTER 
OPERATION OP 1 NOT ODD NUMBERED REGISTER 
NONE 
























Condition Codes 


Wir RESULT = 0, SET TOO 
Wie Resutt <o, set toi 
Wir RESULT >0, SET TO 2 
ClF OVERFLOW, SET TO 3 
[CL] UNCHANGED 

















OOO gOooO8 


The add unnormalized, long format (AW) instruction causes the contents of a double word 
in storage specified by operand 2 to be algebraically added to the contents of the double 
word in the register specified by operand 1 (r,). The sum is placed in the double word in 
the register specified by operand 1 (rj). 


Explicit Format: 







AOPERATION A OPERAND 


[symbol] 
ADLONG 


rd, (x, :b,) 
R4,50(R7,R8) 


Implicit Format: 







A OPERATION A OPERAND 


[symbol] 


ADLONG Aa can 


Operational Consideration: 


= The execution of the AW instruction is identical to the AD instruction (11.2) except 
that the sum is not normalized before being placed in operand 1 (r,). 
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Example: 
LABEL AOPERATIONA OPERAND 
] 10 16 
ADLONG AW R4 FAM 
FAM DC D'IGp' 


Before execution of the add unnormalized, long format (AW) instruction, if we assume 
a value of +900 in R4, the contents of R4 and storage area FAM will be: 


R4 before execution: 


eg Oe ae a | Be ee me 


FAM before and after execution: 


ER EER Ce Re Se Ee 


R4 after execution: 


PEPE p pelt lepepte[efo]m © 
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® AWR 


11.9. ADD UNNORMALIZED, LONG FORMAT (AWR) 


Possible Program Exceptions 


OBJECT || [1] ADDRESSING (1 PROTECTION 


OPCODE FORMAT | INST. 
N 
SEE cere (C0 DATA (INVALID SIGN/DIGIT) | HB SIGNIFICANCE 


(BYTES) || (J) DECIMAL DIVIDE (C0 SPECIFICATION: 


DD DECIMAL OVERFLOW NOT A FLOATING-POINT REGISTER 
Fawr | 2e{ ae | 2  |lGexecure - OP 1 NOT ON HALF:WORD BOUNDARY 


W@ EXPONENT OVERFLOW OP 2 NOT ON HALF-WORD BOUNDARY 
Condition Codes (1 EXPONENT UNDERFLOW OP 2 NOT ON FULL-WORD BOUNDARY 


7) U 0s O oO FIXED-POINT DIVIDE OP 2 NOT ON DOUBLE-WORD 

| Ae Day eae pele C FIXED-POINT OVERFLOW BOUNDARY 

Wir RESULT > 0, SET TO2 0 FLOATING-POINT DIVIDE OP 1 NOT EVEN NUMBERED REGISTER 
(tr OVERFLOW, SET TO 3 # OPERATION OP 1 NOT ODD NUMBERED REGISTER 
(C1 UNCHANGED NONE 





The add unnormalized, long format (AWR) instruction causes the contents of the double- 
word register specified by operand 2 (r,) to be algebraically added to the double-word 
contents of operand 1 (r,). The sum is placed in the operand 1 (r,) register. 


Explicit and Implicit Format: 










A OPERATION A OPERAND 


[symbol] 


ADLONG R4,R6 


Operational Consideration: 





= The execution of the AWR instruction is identical to the ADR instruction (11.3) except 
that the sum is not normalized before being placed in operand 1 (r,). 





Example: 
LABEL AOPERATIONA OPERAND 
1 10 16 
ADLONG AWR R4,R6 
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Before execution of the add unnormalized, long format (AWR) instruction, if we 
assume a value of +900 in R4 and +100 in R6, the contents of R4 and R6 will be: 





R4 before execution: 


Cee eee ee ee 


R6 before and after execution: 


R4 after execution: 


Rae Ree eR 
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11.10. COMPARE, LONG FORMAT (CD) 


General 


OBJECT 
















MB ADDRESSING 












OPCODE 
| orcooe | pik ie ele (J DATA (INVALID SIGN/DIGIT) 
MNEM. (Bytes) || LJ DECIMAL DiviDE 






0 DECIMAL OVERFLOW 

OO Execute 

CO EXPONENT OVERFLOW 
OO ExPONENT UNDERFLOW 
CJ FIXED-POINT DIVIDE 

OJ FIXED-POINT OVERFLOW 
OO FLOATING-POINT DIVIDE 


Condition Codes 


Wir ori = op2, SET TOO 
Bir opi <op2, set To 1 
Wic.opt >or2, set To 2 


Possible Program Exceptions 


@ PROTECTION 
CO SIGNIFICANCE 
CJ SPECIFICATION: 


11-23 





CD 


NOT A FLOATING-POINT REGISTER 

OP 1 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON FULL-WORD BOUNDARY 


OP 2 NOT ON DOUBLE-WORD 
BOUNDARY 


OP 1 NOT EVEN NUMBERED REGISTER 
OP 1 NOT ODD NUMBERED REGISTER 





LJ IF OVERFLOW, SET TO 3 
CJ UNCHANGED 


Wi OPERATION 









OOO sooo 


NONE 





The compare, long format (CD) instruction causes the contents of a double word in the 
register specified by operand 1 (r,) to be algebraically compared with the contents of a 
double word in storage specified by operand 2. The condition code is set by this 
instruction. 


Explicit Format: 







A OPERATION A OPERAND 






[symbol] 
COMPAR 


r, dy (x, ib, ) 
R2,50(R7,R9) 


Implicit Format: 







A OPERATION A OPERAND 





[symbol] 


COMPAR R2,FAM 
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Operational Considerations: 





= =~ Comparison is accomplished by the rules for normalized fixed-point subtraction. The 
operands are equal when the intermediate sum, including the guard digit, is zero. 
= Operands with zero fractions compare as equal even when their signs or exponents 
are different. 
= The condition code is set: 
— to zero when operand 1 equals operand 2; 
— to 1 when operand 1 is less then operand 2; and 
— to 2 when operand 1 is greater than operand 2. 
Code 3 is not used. 
Examples: 
LABEL AOPERATIONA OPERAND 
1 10 16 
COMPARI CD R2 ,FAM3 
COMPAR2 CD R2 ,FAM32 
COMPAR3 CD R2,FAM33 
FAM3 DC D'3' 
FAM32 DC Dp! 32" 
FAM33 DC p33" 


Before execution of the compare, long format (CD) instruction, if we assume a value 
of +32 in R2, then: 


a Example 1 will set a condition code of 2. 
s Example 2 will set a condition code of zero. 


= Example 3 will set a condition code of 1. 
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CDR 


11.11. COMPARE, LONG FORMAT (CDR) 








































OPCODE OBJECT || [ ADDRESSING (PROTECTION 
(NST. 
Bal pee (J DATA (INVALID SIGN/DIGIT) | [] SIGNIFICANCE 








(J DECIMAL DiviDE 

0 DECIMAL OVERFLOW 

OJ execute 

(J EXPONENT OVERFLOW 
(C] EXPONENT UNDERFLOW 
OO FIxXED-POINT DIVIDE 

OO FIxED-POINT OVERFLOW 
CO FLOATING-POINT DIVIDE 
BB OPERATION 


OC SPECIFICATION: 

NOT A FLOATING-POINT REGISTER 
OP 1 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON FULL-WORD BOUNDARY 


OP 2 NOT ON DOUBLE-WORD 
BOUNDARY 


OP 1 NOT EVEN NUMBERED REGISTER 
OP 1 NOT ODD NUMBERED REGISTER 
NONE 


(BY TES) 


Condition Codes 


Mir oP! =o0P2,SsETTOO 
Mir op! <op2,setTo1 
ir oP! >op2, set To 2 
Clif OVERFLOW, SET TO3 
(] UNCHANGED 


MNEM. JHEX. 










OOO OOOO 


The compare, long format (CDR) instruction causes the contents of a double word in the 
register specified by operand 1 (r,) to be algebraically compared with the contents of a 
double word in the register specified by operand 2 (r.). The condition code is set by this 
instruction. 


Explicit and Implicit Format: 







A OPERATION A OPERAND 


[symbol] 


COMPAR R2,R6 


Operational Considerations: 


= Comparison is accomplished by the rules for normalized fixed-point subtraction. The 
operands are equal when the intermediate sum, including the guard digit, is zero. 


= Operands with zero fractions compare as equal even when their signs or exponents 
are different. 


= The condition code is set: 
— to zero when operand 1 equals operand 2; 
— to 1 when operand 1 is less than operand 2; and 
— to 2 when operand 1 is greater than operand 2. 


Code 3 is not used. 
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Examples: 


LABEL AOPERATIONA OPERAND 


1 10 16 

a en eng ae eet Rae NO aT a ae ea ee ee 
COMPAR] CDR R2,R6 

COMPAR2 CDR R2,R4 

COMPAR3 CDR R2,RB 


Before execution of the compare, long format (CDR) instruction, if we assume values 
of +32 in R2, +33 in R6, +32 in R4, and +0 in RO, then: 

= = =6Example 1 will set a condition code of 1. 
= Example 2 will set a condition code of zero. 


a Example 3 will set a condition code of 2. 
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CE 


11.12. COMPARE, SHORT FORMAT (CE) 


Possible Program Exceptions 


@ ADDRESSING @ PROTECTION 

(C0 DATA (INVALID SIGN/DIGIT)| [] SIGNIFICANCE 

CD DECIMAL DIVIDE CJ SPECIFICATION: 

CJ DECIMAL OVERFLOW NOT A FLOATING-POINT REGISTER 

(] EXECUTE OP 1 NOT ON HALF-WORD BOUNDARY 
0 EXPONENT OVERFLOW OP 2 NOT ON HALF-WORD BOUNDARY 
(1 EXPONENT UNDERFLOW OP 2 NOT ON FULL-WORD BOUNDARY 
CD FIXED-POINT DIVIDE OP 2 NOT ON DOUBLE-WORD 

CO FIXED-POINT OVERFLOW BOUNDARY 

C FLOATING-POINT DIVIDE OP 1 NOT EVEN NUMBERED REGISTER 
OPERATION OP 1 NOT ODD NUMBERED REGISTER 

NONE 


OBJECT 
OPCODE FORMAT | INST. 


TYPE LGTH. 
MNEM,. JHEX, (BYTES) 


Condition Codes 


iF oP! = op2, SET TOO 
@ ir opt <op2,set To1 
Bir op! >or2, SET TO 2 
CJIF OVERFLOW, SET TO 3 
[CI UNCHANGED 











a 
O 
O 
a 
O 
O 
O 
0 


The compare, short format (CE) instruction causes the contents of a full word in the 
register specified by operand 1 (r,) to be algebraically compared with the contents of a full 
word in storage specified by operand 2. The condition code is set by this instruction. 


Explicit Format: 







A OPERATION A OPERAND 


[symbol] 
COMPAR 


vr, id, (x, >, ) 
R2,50(R5,R7) 


Implicit Format: 







A OPERATION A OPERAND 





[symbol] 
COMPAR 


14 Sy (Xp) 
R2,FAM 


Operational Considerations: 


= Comparison is accomplished by the rules for normalized fixed-point subtraction. The 
operands are equal when the intermediate sum, including the guard digit, is zero. 


7 Operands with zero fractions compare as equal even when their signs or exponents 
are different. 





UP-8061 Rev. 3 SPERRY UNIVAC OS/3 


ASSEMBLER 


Sa] 9 eee 





= The condition code is set: 





— to zero when operand 1 equals operand 2; 
— to 1 when operand 1 is less than operand 2; and 


— to 2 when operand 1 is greater than operand 2. 


Code 3 is not used. 





Examples: 
LABEL AOPERAT 1ONA OPERAND 
| 10 16 
COMPARI CE R2 ,FAM3 
COMPAR2 CE R2 , FAM32 
COMPAR3 CE R2,FAM33 
FAM3 Dc E35." 
FAM32 Dc E'32' 
FAM33 DC E'33' 
_Before execution of the compare, short format (CE) instructions, if we assume a value & 
of +32 in R2, then: 


= Example 1 will set a condition code of 2. 
= Example 2 will set a condition code of zero. 


= Example 3 will set a condition code of 1. 
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CER 


11.13. COMPARE, SHORT FORMAT (CER) 


General Possible Program Exceptions 
OBJECT 
ADDRESSING (CD PROTECTION 
OPCODE FORMAT | INST. O 
TYPE LGTH. 


[] DATA (INVALID SIGN/DIGIT) CJ SIGNIFICANCE 
MNEM. |HEX., (BYTES) 


| mivem. | (J DECIMAL DIVIDE C] SPECIFICATION: 
cen OC DECIMAL OVERFLOW NOT A FLOATING-POINT REGISTER 
Condition Codes 


QO execute OP 1 NOT ON HALF-WORD BOUNDARY 
() EXPONENT OVERFLOW OP 2 NOT ON HALF-WORD BOUNDARY 
C EXPONENT UNDERFLOW OP 2 NOT ON FULL-WORD BOUNDARY 

BE ror! -or2, Sit Too CO FIXED-POINT DIVIDE OP 2 NOT ON DOUBLE-WURD 

Bi IF op! <op2, SET TO14 (C0 FIXED-POINT OVERFLOW BOUNDARY 

IF oP! > oP2, SET TO 2 

CJIF OVERFLOW, SET TO3 

CU UNCHANGED 











































CO FLOATING-POINT DIVIDE OP 1 NOT EVEN NUMBERED REGISTER 
OPERATION OP 1 NOT ODD NUMBERED REGISTER 
NONE 


OOO OOOO 


The compare, short format (CER) instruction causes the full-word contents of the register 
specified by operand 1 (r,) to be algebraically compared with the contents of a full word in 
the register specified by operand 2 (r.). The condition code is set by this instruction. 


Explicit and Implicit Format: 







A OPERATION A OPERAND 


[symbol] 


COMPAR R4,R6 


Operational Considerations: 


= Comparison is accomplished by the rules for normalized fixed-point subtraction. The 
operands are equal when the intermediate sum, including the guard digit, is zero. 


= Operands with zero fractions compare as equal even when their signs or exponents 
are different. 


= The condition code is set: 
— to zero when operand 1 equals operand 2; 
— to 1 when operand 1 is less than operand 2; and 
— to 2 when operand 1 is greater than operand 2; 


Code 3 is not used. 
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Examples: 
LABEL AOPERATIONA OPERAND 
1 10 16 
COMPAR] CER R4,RO 
COMPAR2 CER R4 ,R2 
COMPAR3 CER R4,R6 


Before execution of the compare, short format (CER) instructions, if we assume values 
of +32 in R4, +3 in RO, +32 in R2, and +33 in R6, then 


a Example 1 will set a condition code of 2. 
a Example 2 will set a condition code of zero. 


= Example 3 will set a condition code of 1. 
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DD 


11.14. DIVIDE, LONG FORMAT (DD) 


; General Possible Program Exceptions 
OBJECT ADDRESSING @ PROTECTION 
OPCODE FORMAT | INST. e 
TYPE LGTH. 


O DATA (INVALID SIGN/DIGIT) oO SIGNIFICANCE 


(J DECIMAL DIVIDE C] SPECIFICATION: 
| op feo] ax | 4 | CL DECIMAL OVERFLOW NOT A FLOATING-POINT REGISTER 
Condition Codes 


(J ExECUTE OP 1 NOT ON HALF-WORD BOUNDARY 
EXPONENT OVERFLOW OP 2 NOT ON HALF-WORD BOUNDARY 
EXPONENT UNDERFLOW OP 2 NOT ON FULL-WORD BOUNDARY 
PlinnesUle o sero o CO FIXED-POINT DIVIDE OP 2 NOT ON DOUBLE-WORD 
Clie RESULT <0, SET TO 14 CJ FIXED-POINT OVERFLOW BOUNDARY 
Clit RESULT > 0, SET TO 2 
Cif OVERFLOW, SET TO3 
ME UNCHANGED 








































W@ FLOATING-POINT DIVIDE OP 1 NOT EVEN NUMBERED REGISTER 
Bi OPERATION OP 1 NOT ODD NUMBERED REGISTER 
NONE 


OOO gOoOg 


The divide, long format (DD) instruction causes the double-word contents of the operand 1 
(r,;) register to be divided by the contents of the double word in storage specified by 
operand 2. The normalized quotient is placed in the register specified by operand 1 (r,). 
Any remainder is not preserved. 


Explicit Format: 







A OPERATION A OPERAND 


[symbol] 
DIVLONG 


rd, (x, ,b,) 
R4,33(R7,R10) 


Implicit Format: 







A OPERATION A OPERAND 
[symbol] 


DIVLONG R4,FAM 


Operational Considerations: 


= Floating-point division consists of exponent subtraction and fraction division. The 
intermediate quotient exponent is obtained by subtracting the exponents of the two 
operands and increasing the difference by 64. 
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= Both operands are normalized before division. Consequently, the intermediate 
quotient is correctly normalized or a right shift of one digit position may be required. 
The exponent of the intermediate result is increased by 1 if the shift is necessary. All 
operand 1 (r,) fraction digits are used in forming the quotient, even if the normalized 
operand 1 fraction is larger than the normalized operand 2 fraction. 


= ~§=6lIf the final quotient exponent exceeds 127, an exponent overflow exception results. 
The quotient consists of the correct and normalized fraction, a correct sign, and an 
exponent which is 128 less than the correct value. 


= If the final quotient exponent is less than zero, an exponent underflow condition 
exists. If the exponent underflow mask bit of the current PSW is 1, the quotient has a 
correct and normalized fraction, a correct sign, and an exponent which is 128 greater 
than the correct value. If the exponent underflow mask bit of the current PSW is zero, 
the result is made a true zero. Underflow does not apply to the intermediate result or 
the operands during normalization. An exponent underflow exception causes a 
program interrupt if the exponent underflow mask bit of the current PSW is 1. 


= #Attempted division by a divisor with a zero fraction leaves the dividend unchanged, 
and a program exception for floating-point divide occurs. When division of a zero 
dividend is attempted, the quotient fraction is zero. The quotient sign and exponent 
are made zero and give a true zero result. No program exceptions occur. 





Example: 
LABEL AOPERATIONA OPERAND 
1 10 16 
DIVIDLG DD R4 FAM 
FAM oC D'S! 


Before execution of the divide, long format (DD) instruction, if we assume a value of 
+1000 in R4, the contents of R4 and storage area FAM will be: 


R4 before execution: 


BEES ee 


FAM before and after execution: 


Fe ee a a 


R4 after execution: 
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DDR 


11.15. DIVIDE, LONG FORMAT (DDR) 


Possible Program Exceptions 
OPCODE FORMAT 
TYPE LGTH. 


(J ADDRESSING C PROTECTION 
(1 DATA (INVALID SIGN/DIGIT)| [) SIGNIFICANCE 


CJ DECIMAL DivIDE DO SPECIFICATION: 
Condition Codes 


(1 DECIMAL OVERFLOW NOT A FLOATING-POINT REGISTER 
OO Execute OP 1 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON FULL-WORD BOUNDARY 
Elie RecGe TS UcEr TOO OP 2 NOT ON DOUBLE-WORD 
Cir RESULT <0, SET TO1 
Cir RESULT > 0, SET TO 2 
CIF OVERFLOW, SET TO 3 
BB UNCHANGED 










eee ECT 
INST. 








@ EXPONENT OVERFLOW 
@ EXPONENT UNDERFLOW 
OD FIXED-POINT DIVIDE 

C0 FIXED-POINT OVERFLOW 
Wl FLOATING-POINT DIVIDE 
BB OOPERATION 


BOUNDARY 

OP 1 NOT EVEN NUMBERED REGISTER 

OP 1 NOT ODD NUMBERED REGISTER 
NONE 








OOO OOOO 





The divide, long format (DDR) instruction causes the double-word contents of the operand 
1 (r,;) register to be divided by the double-word contents of the operand 2 (r.) register. The 
normalized quotient is placed in the operand 1 (r,) register. Any remainder is not 
preserved. 


Explicit and Implicit Format: 







AOPERATION A OPERAND 






[symbol] 


DIVLONG R2,R6 


Operational Considerations: 


= Floating-point division consists of exponent subtraction and fraction division. The 
intermediate quotient exponent is obtained by subtracting the exponents of the two 
operands and increasing the difference by 64. 


a Both operands are normalized before division. Consequently, the intermediate 
quotient is correctly normalized or a right shift or one digit position may be required. 
The exponent of the intermediate result is increased by 1 if the shift is necessary. All 
operand 1 (r,) fraction digits are used in forming the quotient even if the normalized 
operand 1 (r,) fraction is larger than the normalized operand 2 (r2) fraction. 
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s If the final quotient exponent exceeds 1 27, an exponent overflow exception results. 
The quotient consists of the correct and normalized fraction, a correct sign, and an 
exponent which is 128 less than the correct value. 


2 if the final quotient exponent is less than zero, an exponent underflow condition 
exists. If the exponent underflow mask bit of the current PSW is 1, the quotient has a 
correct and normalized fraction, a correct sign, and an exponent which is 128 greater 
than the correct value. If the exponent underflow mask bit of the current PSW is zero, 
the result is made a true zero. Underflow does not apply to the intermediate result or 
the operands during normalization. 


s Attempted division by a divisor with a zero fraction leaves the dividend unchanged, 
and a program exception for floating-point divide occurs. When division of a zero 
dividend is attempted, the quotient fraction is zero. The quotient sign and exponent 
are made zero and give a true zero result. No program exceptions occur. 








Example: 
LABEL AOPERATIONA OPERAND 
1 10 16 
DIVIDLG DDR R2,R6 


Before execution of the divide, long format (DDR) instruction, if we assume values of 
+1000 in R2 and +5 in R6, the contents of R2 and R6 will be: 


R2 before execution: 


eS ES Poe Re 


R6 before and after execution: 


fe ee ee ee ee eee 


R2 after execution: 
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11.16. DIVIDE, SHORT FORMAT (DE) 


Possible Program Exceptions 




























—_"__- M ADDRESSING W@ PROTECTION 
OPCODE | FoRMAT | INST. 
TYPE LGTH. (J DATA (INVALID SIGN/DIG!IT) | [1] SIGNIFICANCE 
(Bytes) || D DECIMAL DIVIDE CO sPECIFICATION: 


OD DECIMAL OVERFLOW 

CO execute 

fi EXPONENT OVERFLOW 
ME EXPONENT UNDERFLOW 
OC FIXED-POINT DIVIDE 

(C0 FIxXED-POINT OVERFLOW 
Wl FLOATING-POINT DIVIDE 
HE OPERATION 


NOT A FLOATING-POINT REGISTER 

OP 1 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON FULL-WORD BOUNDARY 


OP 2 NOT ON DOUBLE-WORD 
BOUNDARY 


OP 1 NOT EVEN NUMBERED REGISTER 
OP 1 NOT ODD NUMBERED REGISTER 
NONE 


Condition Codes 


CIF RESULT = 0, SET TOO 
Or RESULT <0, SET TO1 
Clif RESULT > 0, SET TO 2 
CIF OVERFLOW, SET TO 3 
BB UNCHANGED 







OOO O8 OO 


The divide, short format (DE) instruction causes the full-word contents of the operand 1 (r,) 
register to be divided by the full-word contents of a full word in storage specified by 
operand 2. The normalized quotient is placed in a full word in the operand 1 (r,) register. 
Any remainder is not preserved. 


Explicit Format: 






A OPERATION A OPERAND 






[symbol] 
DIVSHORT 


41d) (xp ,b2) 
R4,32(R8,R9) 


Implicit Format: 







A OPERATION A OPERAND 
[symbol] 


DIVSHORT R4,FAM 


Operational Considerations: 


5 Floating-point division consists of exponent subtraction and fraction division. The 
intermediate quotient exponent is obtained by subtracting the exponents of the two 
operands and increasing the difference by 64. 
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= Both operands are normalized before division. Consequently, the intermediate 
quotient is correctly normalized or a right shift of one digit position may be required. 
The exponent of the intermediate result is increased by 1 if the shift is necessary. All 
operand 1 (r,) fraction digits are used in forming the quotient even if the normalized 
operand 1 (r,) fraction is larger than the normalized operand 2 fraction. 





a if the final quotient exponent exceeds 127, an exponent overflow exception results. 
The quotient consists of the correct and normalized fraction, a correct sign, and an 
exponent which is 128 less than the correct value. 


. If the final quotient exponent is less than zero, an exponent underflow condition 
exists. If the exponent underflow mask bit of the current PSW is 1, the quotient has a 
correct and normalized fraction, a correct sign, and an exponent which is 128 greater 
than the correct value. If the exponent underflow mask bit of the current PSW is zero, 
the result is made a true zero. Underflow does not apply to the intermediate result or 
the operands during normalization. 


# Attempted division by a divisor with a zero fraction leaves the dividend unchanged 
and a program exception for floating-point divide occurs. When division of a zero 
dividend is attempted, the quotient fraction is zero. The quotient sign and exponent 
are made zero and give a true zero result. No program exceptions occur. 








Example: 
LABEL AOPERATIONA OPERAND 
1 10 16 
DIVIDESH DE R4 FAM 
FAM DC E'5' 


Before execution of the divide, short format (DE) instruction, if we assume a value of 
+1000 in R4, the contents of R4 and storage area FAM will be: 


R4 before execution: 


ere Se oa |; teen 
FAM before and after execution: 
PARES 
R4 after execution: 
a4i2i{[ctes poroforo| +200 
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11.17. DIVIDE, SHORT FORMAT (DER) 


OPCODE FORMAT 
TYPE 
| mivem. | HEX. | 


Condition Codes 


Clif RESULT = 0, SET TOO 
Cif RESULT <O, SET TO1 
Clif RESULT > 0, SET TO 2 
CJ \F OVERFLOW, SET TO 3 






















a (] ADDRESSING 















oe (1 DATA (INVALID SIGN/DIGIT) 
(BYTES) || CL] DECIMAL DiviDE 








(C2 DECIMAL OVERFLOW 

0 execute 

WB EXPONENT OVERFLOW 
@ EXPONENT UNDERFLOW 
O FIXED-POINT DIVIDE 

0 F1xED-POINT OVERFLOW 
HE FLOATING-POINT DIVIDE 


Possible Program Exceptions 


C1 PROTECTION 
CL] SIGNIFICANCE 
0 SPECIFICATION: 


11-37 


DER 


NOT A FLOATING-POINT REGISTER 

OP 1 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON FULL-WORD BOUNDARY 


OP 2 NOT ON DOUBLE-WORD 
BOUNDARY 


OP 1 NOT EVEN NUMBERED REGISTER 
OP 1 NOT ODD NUMBERED REGISTER 









BBOOPERATION 





OOO OOOOS 


BE UNCHANGED NONE 


The divide, short format (DER) instruction causes the full-word contents of the operand 1 
(r;) register to be divided by the full-word contents of the operand 2 (r,) register. The 
normalized quotient is placed in a full word in the operand 1 (r,) register. Any remainder is 
not preserved. 


Explicit and Implicit Format: 








A OPERATION A OPERAND 
[symbol] 


DIVSHORT| DER R4,R6 


Operational Considerations: 


= Floating-point division consists of exponent subtraction and fraction division. The 
intermediate quotient exponent is obtained by subtracting the exponents of the two 
operands and increasing the difference by 64. 


7 Both operands are normalized before division. Consequently, the intermediate 
quotient is correctly normalized or a right shift of one digit position may be required. 
The exponent of the intermediate result is increased by 1 if the shift is necessary. All 
operand 1 (r,) fraction digits are used in forming the quotient even if the normalized 
operand 1 (r,) fraction is larger than the normalized operand 2 (r2) fraction. 
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If the final quotient exponent exceeds 127, an exponent overflow exception results. 
The quotient consists of the correct and normalized fraction, a correct sign, and an 
exponent which is 128 less than the correct value. 


If the final quotient exponent is less than zero, an exponent underflow condition 
exists. If the exponent underflow mask bit of the current PSW is 1, the quotient has a 
correct and normalized fraction, a correct sign, and an exponent which is 128 greater 
than the correct value. If the exponent underflow mask bit of the current PSW is zero, 
the result is made a true zero. Underflow does not apply to the intermediate result or 
the operands during normalization. 


Attempted division by a divisor with a zero fraction leaves the dividend unchanged 
and a program exception for floating-point divide occurs. When division of a zero 
dividend is attempted, the quotient fraction is zero. The quotient sign and exponent 
are made zero and give a true zero result. No program exceptions occur. 


Example: 





LABEL AOPERATIONA OPERAND 
1 10 16 
DIVIDESH DER R4 ,R6 


Before execution of the divide, short format (DER) instruction, if we assume values of 
+1000 in R4 and +5 in R6, the contents of R4 and R6 will be: 


R4 before execution: 


+1000 


R4 after execution: 


Rare 


+200 
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HDR 


11.18. HALVE, LONG FORMAT (HDR) 


Possible Program Exceptions 


(J ADDRESSING ( PROTECTION 

(0 DATA (INVALID SIGN/DIGIT) | [] SIGNIFICANCE 

(J DECIMAL DIVIDE Wi SPECIFICATION: 

1 DECIMAL OVERFLOW NOT A FLOATING-POINT REGISTER 
O execute OP 1 NOT ON HALF-WORD BOUNDARY 


OBJECT 
OPCODE FORMAT | INST. 


TYPE LGTH. 
(BYTES) 


Condition Codes 


Of RESULT = 0, SET TOO 
Or RESULT <0, SET TO1 
Cir RESULT > 0, SET TO 2 
CIF OVERFLOw, SET TO 3 
BB UNCHANGED 





(CJ EXPONENT OVERFLOW OP 2 NOT ON HALF-WORD BOUNDARY 
WE EXPONENT UNDERFLOW OP 2 NOT ON FULL-WORD BOUNDARY 
(C) FIXED-POINT DIVIDE OP 2 NOT ON DOUBLE-WORD 


OD FIXED-POINT OVERFLOW BOUNDARY 
C FLOATING-POINT DIVIDE OP 1 NOT EVEN NUMBERED REGISTER 


Hi OPERATION OP 1 NOT ODD NUMBERED REGISTER 
NONE 






The halve, long format (HDR) instruction causes the double-word contents of the operand 
2 (r2) register to be divided by 2. The normalized quotient is placed in the double-word 
operand 1 (r,) register. 


Explicit and Implicit Format: 







AOPERATION A OPERAND 


[symbol] 


HALVE R4,R6 


Operational Considerations: 


= The fraction of operand 2 (r.) is shifted right one bit position. The least significant bit 
of the fraction is placed into the most significant bit position of the guard digit, and 
the vacated fraction bit position is filled with zero. The intermediate result is 
normalized and placed in the operand 1 (r,) location. 


Bs When normalization causes the exponent to become less than zero, an exponent 
underflow condition exists. If the exponent underflow mask bit of the current program 
status word (PSW) is 1, the exponent of the result is 128 greater than the correct 
value. If the exponent underflow mask bit of the current PSW is zero, the result is 
made true zero. 


= When the fraction of operand 2 (r.) is zero, the result is made a true zero, a 
normalization is not attempted, and a significance exception does not occur. 
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Example: 
LABEL AOPERAT IONA OPERAND 
1 10 16 
HALF HDR R4 ,R6 


Before execution of the halve, long format (HDR) instruction, if we assume values of 
+0 in R4 and +1000 in R6, the contents of R4 and R6 will be: 


ERE Ee Ree eee 


R6 before and after execution: 


Reece Rees eee 


R4 after execution: 


REE RE Ee ee 











UP-8061 Rev. 3 SPERRY UNIVAC OS/3 11-41 
ASSEMBLER 


HER 


11.19. HALVE, SHORT FORMAT (HER) 


Possible Program Exceptions 



































édesoe OBJECT || [ADDRESSING C) PROTECTION 
Peoee pate (1 DATA (INVALID SIGN/DIGIT)| [] SIGNIFICANCE 
(BYTES) |} L) DECIMAL DIVIDE CL] SPECIFICATION: 





(1 DECIMAL OVERFLOW 

C] execute 

CC) EXPONENT OVERFLOW 
EXPONENT UNDERFLOW 
CO) FIXED-POINT DIVIDE 

CO FIXED-POINT OVERFLOW 
C1 FLOATING-POINT DIVIDE 
WI OPERATION 


NOT A FLOATING-POINT REGISTER 

OP 1 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON FULL-WORD BOUNDARY 


OP 2 NOT ON DOUBLE-WORD 
BOUNDARY 


OP 1 NOT EVEN NUMBERED REGISTER 
OP 1 NOT ODD NUMBERED REGISTER 
NONE 






Condition Codes 


Clif RESULT =0,SETTOO 
Cif RESULT <0, SETTO1 
Clif RESULT >0, SET TO 2 
CF OVERFLOw, SET TO3 
GE UNCHANGED 

























OOO OOOO 


The halve, short format (HER) instruction causes the full-word contents of the operand 2 
(r.) register to be divided by 2. The normalized quotient is placed in the full word in the 
operand 1 (r,) register. 


Explicit and Implicit Format: 







A OPERATION A OPERAND 


[symbol] 


HALVE R4,R6 


Operational Considerations: 


= ~=6The fraction of operand 2 (ra) is shifted right one bit position. The least significant bit 
of the fraction is placed into the most significant bit position of the guard digit, and 
the vacated fraction bit position is filled with zero. The intermediate result is 
normalized and placed in the operand 1 (r,) location. 


# When normalization causes the exponent to become less than zero, an exponent 
underflow condition exists. If the exponent underflow mask bit of the current program 
status word (PSW) is 1, the exponent of the result is 128 greater than the correct 
value. If the exponent underflow mask bit of the current PSW is zero, the result is 
made true zero. 


a When the fraction of operand 2 (r,) is zero, the result is made a true zero, 
normalization is not attempted, and a significance exception does not occur. 
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LABEL AOPERATIONA OPERAND 
1 10 16 
HALF HER R4 RE 


Before execution of the halve, short format (HER) instruction, if we assume values of 
+1000 in R4 and +0 in R6, the contents of R6 and R4 will be: 


R4 before execution: 


Pees eer ee) «2 


R6 before and after execution: 


+1000 


R4 after execution: 


eee Oe ee eee] hey ee 
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11.20. LOAD COMPLEMENT, LONG FORMAT (LCDR) 


Possible Program Exceptions 


[1] ADDRESSING CJ PROTECTION 

(J DATA (INVALID SIGN/DIGIT)] 1) SIGNIFICANCE 

(1 DECIMAL DivIDE C0 SPECIFICATION: 

(1) DECIMAL OVERFLOW NOT A FLOATING-POINT REGISTER 
DO execute OP 1 NOT ON HALF-WORD BOUNDARY 
C1 EXPONENT OVERFLOW OP 2 NOT ON HALF-WORD BOUNDARY 
CL) ExPONENT UNDERFLOW OP 2 NOT ON FULL-WORD BOUNDARY 
C] FIXED-POINT DIVIDE OP 2 NOT ON DOUBLE-WORD 


CO FIXED-POINT OVERFLOW BOUNDARY 
(J FLOATING-POINT DIVIDE OP 1 NOT EVEN NUMBERED REGISTER 


MH OPERATION OP 1 NOT ODD NUMBERED REGISTER 
NONE 





OBJECT 
OPCODE FORMAT | INST. 
TYPE LGTH. 



















Loon | 23] AR | 2 


Condition Codes 














W iF RESULT = 0,SET TOO 
Mie REsuLT <0, SET TO1 
Bit RESULT >0O, SET TO 2 
OIF OVERFLOW, SET TO 3 
( UNCHANGED 


OOO OOOOS 


The load complement, long format (LCDR) instruction causes the sign of the double-word 
contents of the operand 2 (r.) register to be reversed. The result is placed in the double 
word in the operand 1 (r,) register. 


Explicit and Implicit Format: 







A OPERATION A OPERAND 


[symbol] 


SIGN R6,R4 


Operational Considerations: 
= =The exponent and fraction are not changed. 
= The contents of operand 2 (r,) remain unchanged. 
= The condition code is set: 
— to zero if result is zero; 
— to 1 if result is less than zero; and 
— to 2 if result is greater than zero. 


~ Code 3 is not used. 
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Example: 
LABEL AOPERATIONA OPERAND 
1 10 16 
S1GN LCDR R6,R4 


Before execution of the /oad complement, long format (LCDR) instruction, if we 
assume values of +1000 in R4 and +0 in R6, the contents of R6 and R4 will be: 


R6 before execution: 


Rear Ree ee 


R4 before and after execution: 


Ea Dre 


R6 after execution: 


PPPEEPPPPPPPPE PPT» © 
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11.21. LOAD COMPLEMENT, SHORT FORMAT (LCER) 


Possible Program Exceptions 
OPCODE =" __ (] ADDRESSING (CO PROTECTION 
reeee ae (I DATA (INVALID SIGN/DIGIT) | [) SIGNIFICANCE 


OD DECIMAL OVERFLOW 
icen [os [ae | 2 |[Denecure 


(Bytes) || (J DECIMAL DIVIDE OC SPECIFICATION: 

NOT A FLOATING-POINT REGISTER 
OP 1 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON FULL-WORD BOUNDARY 


OP 2 NOT ON DOUBLE-WORD 
BOUNDARY 


OP 1 NOT EVEN NUMBERED REGISTER 
OP 1 NOT ODD NUMBERED REGISTER 
NONE 


C0 EXPONENT OVERFLOW 
Condition Codes CO EXPONENT UNDERFLOW 
Mir RESULT = 0, SET TOO El ERED EOIN DIVIDE 
Wit RESULT <0, SETTO1 O] FIxED-POINT OVERFLOW 
Wir RESULT >0, SET TO 2 C1 FLOATING-POINT DIVIDE 


CJ IF OVERFLOW, SET TO 3 BB OPERATION 
(UNCHANGED 





OOO OOOO 


The load complement, short format (LCER) instruction causes the sign of the full-word 
contents of the operand 2 (r.) register to be reversed. The result is placed in the full word 
in the operand 1 (r,) register. 


Explicit and Implicit Format: 







A OPERATION A OPERAND 


[symbol] 


SIGN R6,R4 


Operational Considerations: 
= The exponent and fraction are not changed. 
= The contents of operand 2 (r.) remain unchanged. 
= The condition code is set: 
— to zero if result is zero; 
— to 1 if result is less than O; and 
— to 2 if result is greater than zero. 


Code 3 is not used. 
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Example: 
LABEL AOPERATIONA OPERAND 
1 10 16 
SIGN LCER R6 ,RA 


Before execution of the /oad complement, short format (LCER) instruction, if we 
assume values of +1000 in R4 and +0 in R6, the contents of R6 and R4 will be: 


R6 before execution: 


Ee 


R4 before and after execution: 


+1000 


R6 after execution: 














ao : : ‘oh 
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11.22. LOAD, LONG FORMAT (LD) 


Possible Program Exceptions 














OPCODE OBJECT || g ADDRESSING Mi PROTECTION 
eee cern C DATA (INVALID SIGN/DIGIT) | [] SIGNIFICANCE 
(Bytes) || LJ DECIMAL DiviDE CO SPECIFICATION: 





NOT A FLOATING-POINT REGISTER 

OP 1 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON FULL-WORD BOUNDARY 


OP 2 NOT ON DOUBLE-WORD 
BOUNDARY 


OP 1 NOT EVEN NUMBERED REGISTER 
OP 1 NOT ODD NUMBERED REGISTER 
NONE 


CZ DECIMAL OVERFLOW 

OD execute 

(1 EXPONENT OVERFLOW 
CO] ExPONENT UNDERFLOW 
C] FIXED-POINT DIVIDE 

OO FIxXED-POINT OVERFLOW 
0 FLOATING-POINT DIVIDE 
BB OOPERATION 


| to feos] rx | 4 | 
Condition Codes 


CIF RESULT = 0,SET TOO 
DJF RESULT <0, SET TO 1 
CF RESULT > 0, SET TO 2 
CIF OVERFLOW, SET TO 3 
BB UNCHANGED 








a 
O) 
O 
O 
a 
0 
O 
0 





The /oad, long format (LD) instruction causes the contents of a double word in storage 
specified by operand 2 to be placed in the double word in the operand 1 (r,) register. 


& Explicit Format: 






AOPERATION A OPERAND 






rd (x, b,) 
R4,33(R8,R9) 


Implicit Format: 







A OPERATION A OPERAND 





[symbol] 


LOAD R4,FAM 


Operational Consideration: 


= The contents of operand 2 remain unchanged. 
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Example: 
LABEL AOPERATIONA OPERAND 
] 10 16 
LOAD LD R4 ,FAM 
FAM DC D'156' 


Before execution of the /oad, /ong format (LD) instruction, if we assume a value of +O 
in R4, the contents of R4 and main storage area FAM will be: 


R4 before execution: 


Ree eee ERE eee 


FAM before and after execution: 


R4 after execution: 


PPPEPPPEPP PPP rP—P Ppt» © 
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@ LDR 














aaa 


11.23. LOAD, LONG FORMAT (LDR) 
INST. 


Possible Program Exceptions 
OPCODE FORMAT 
TYPE LGTH. 


mun 
ion fan | 2 


Condition Codes 


C1F RESULT = 0,SET TOO 
Clie RESULT <0, SETTO1 
OCF RESULT > 0, SET TO 2 
OF OVERFLOW, SET TO 3 
WUNCHANGED 


(J ADDRESSING (PROTECTION 

(1 DATA (INVALID SIGN/DIGIT)| (] SIGNIFICANCE 
(J DECIMAL DivIDE CJ SPECIFICATION: 
0 DECIMAL OVERFLOW 
0 Execute 


NOT A FLOATING-POINT REGISTER 

OP 1 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON FULL-WORD BOUNDARY 


OP 2 NOT ON DOUBLE-WORD 
BOUNDARY 


OP 1 NOT EVEN NUMBERED REGISTER 
OP 1 NOT ODD NUMBERED REGISTER 
NONE 


OC EXPONENT OVERFLOW 
C1 ExPONENT UNDERFLOW 
0 FIXED-POINT DIVIDE 

C1 FIxXeD-POINT OVERFLOW 
OJ FLOATING-POINT DIVIDE 
GE OPERATION 


OOO OOOO 





The foad, long format (LDR) instruction causes the contents of the double word in the 
operand 2 (r.) register to be placed in the double word in the operand 1 (r,) register. 


e Explicit and Implicit Format: 







A OPERATION A OPERAND 


[symbol] 


LOAD R6,R4 


Operational Consideration: 


= The contents of operand 2 (r.) remain unchanged. 














Example: 
LABEL AOPERATIONA OPERAND 
1 10 16 
LOAD LDR R6,R4 
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Before execution of the /oad, long format (LDR) instruction, if we assume values of 
+150 in R4 and +0 in R6, the contents of R6 and R4 will be: 


R6 before execution: 


conn cE Ee eae aE eS 


R4 before and after execution: 


R6 after execution: 
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LE 


11.24. LOAD, SHORT FORMAT (LE) 


Possible Program Exceptions 


@ ADDRESSING HB PROTECTION 

(C1 DATA (INVALID SIGN/DIGIT)| [] SIGNIFICANCE 

(CJ DECIMAL Divide CO SPECIFICATION: 

CJ DECIMAL OVERFLOW NOT A FLOATING-POINT REGISTER 

(0 execute OP 1 NOT ON HALF-WORD BOUNDARY 
C] EXPONENT OVERFLOW OP 2 NOT ON HALF-WORD BOUNDARY 
(C0 EXPONENT UNDERFLOW OP 2 NOT ON FULL-WORD BOUNDARY 
C1 FIXED-POINT DIVIDE OP 2 NOT ON DOUBLE-WORD 

OC F1xXED-POINT OVERFLOW BOUNDARY 

C0 FLOATING-POINT DIVIDE OP 1 NOT EVEN NUMBERED REGISTER 
OPERATION OP 1 NOT ODD NUMBERED REGISTER 

NONE 





















OBJECT 
OPCODE FORMAT | INST. 
TYPE LGTH. 


MNEM. (BYTES) 


















Condition Codes 






OO iF RESULT = 0, SET TOO 
Dif RESULT <0, SET TO 1 
Cie RESULT >0, SET TO 2 
OJIF OVERFLOW, SET TO 3 
BB UNCHANGED 


OOO OS8O0O8 


The /oad, short format (LE) instruction causes the contents of a full word in storage 
specified by operand 2 to be placed in a full word in the operand 1 (r,) register. 


Explicit Format: 





A OPERATION A OPERAND 






ry dy (xy ,b,) 


LOAD R6,33(R8,R9) 


Implicit Format: 








A OPERATION A OPERAND 


[symbol] 


LOAD R6,FAM 


Operational Consideration: 


= The contents of operand 2 remain unchanged. 
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Example: 
LABEL AOPERATIONA OPERAND 
1 10 16 
LOAD LE R6,FAM 
FAM oC E'156' 


Before execution of the /oad, short format (LE) instruction, if we assume a value of +0 
in R6, the contents of R6 and main storage area FAM will be: 


R6 before execution: 


Paes 


FAM before and after execution: 


R6 after execution: 





+150 
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LER 


11.25. LOAD, SHORT FORMAT (LER) 


General Possible Program Exceptions 
OBJECT 
OPCODE FORMAT | INST. 
TYPE LGTH. 


| terse | rr | 2 | 


Condition Codes 


Clif RESULT = 0,SET TOO 







(1) ADDRESSING OC PROTECTION 

(0 DATA (INVALID SIGN/DIG!T)| [] SIGNIFICANCE 
CO DECIMAL DiviDE C SPECIFICATION: 
C] DECIMAL OVERFLOW 
(J Execute 






NOT A FLOATING-POINT REGISTER 

OP 1 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON FULL-WORD BOUNDARY 


OP 2 NOT ON DOUBLE-WORD 
BOUNDARY 


OP 1 NOT EVEN NUMBERED REGISTER 
OP 1 NOT ODD NUMBERED REGISTER 
NONE 


(C0 EXPONENT OVERFLOW 
CJ EXPONENT UNDERFLOW 
CO FIXED-POINT DIVIDE 

CJ FIXED-POINT OVERFLOW 
0 FLOATING-POINT DIVIDE 
OPERATION 


(Jif RESULT <o,SETTO1 
Clif RESULT >0, SET TO2 
(JF OVERFLOW, SET TO3 
HBUNCHANGED 


OO0 OOOOS8 





The /oad, short format (LER) instruction causes the contents of a full word in the operand 
2 (r2) register to be placed in a full word in the operand 1 (r,) register. 


Explicit and Implicit Format: 







AOPERATION A OPERAND 


[symbol] 


LOAD R6,R4 


Operational Consideration: 


= The contents of operand 2 (r,) remain unchanged. 


Example: 
LABEL AOPERATIONA OPERAND 
1 10 16 





gp A AS 


LOAD LER R6,R4 
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Before execution of the /oad, short format (LER) instruction, if we assume values of 
+150 in R4 and +0 in R6, the contents of R6 and R4 will be: 


R6 before execution: 


+0 


R6 after execution: 


+150 
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11.26. LOAD NEGATIVE, LONG FORMAT (LNDR) 


OBJECT |) 7 ADDRESSING CO PROTECTION 





































OPCODE uM INST 
Cee peed C1 DATA (INVALID SIGN/DIGIT) | [] SIGNIFICANCE 
MNEM. (pytes) |] DJ DECIMAL DIVIDE C sPeciFICATION: 










CJ DECIMAL OVERFLOW 

(OJ execute 

CO] EXPONENT OVERFLOW 
C1] ExPONENT UNDERFLOW 
OC Ftx€D-POINT DIVIDE 

C1 FIXED-POINT OVERFLOW 
CF FLOATING-POINT DIVIDE 
BB OPERATION 


NOT A FLOATING-POINT REGISTER 

OP 1 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON FULL-WORD BOUNDARY 


OP 2 NOT ON DOUBLE-WORD 
BOUNDARY 


OP 1 NOT EVEN NUMBERED REGISTER 
OP 1 NOT ODD NUMBERED REGISTER 
NONE 


unor | 1 | an | 2 | 
Condition Codes 


Mir RESULT = 0, SET TOO 
Mie RESULT <0, SETTO1 
OCJiF RESULT > 0, SET TO 2 
(iF OVERFLOW, SET TO 3 
LL) UNCHANGED 


OOO OOOO 





The load negative, long format (LNDR) instruction causes the sign of the double word in 
the operand 2 (r,) register to be made negative. The result is placed in the double-word 
register specified by operand 1 (r,). 


Explicit and Implicit Format: 


A OPERATION A OPERAND 





Operational Considerations: 
= Operand 2 (r.) is made negative even if the fraction is zero. 
= The exponent and fraction are not changed. 
= The contents of operand 2 (r,) remain unchanged. 
= The condition code is set: 
— to zero if result is zero; and 
— to 1 if result is less than zero. 


Codes 2 and 3 are not used. 
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Example: 
LABEL AOPERATIONA OPERAND 
1 10 16 
LOAD LNDR R2,R6 


Before execution of the /oad negative, long format (LNDR) instruction, if we assume 
values of +150 in R6 and +0 in R2, the contents of R2 and R6 will be: 


R2 before execution: 


EER ES ce Eee EERE 


R6 before and after execution: 


R2 after execution: 


ee ey ea eee oa ee eee ei 3—| 
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LNER 


11.27. LOAD NEGATIVE, SHORT FORMAT (LNER) 


Possible Program Exceptions 







OBJECT 


OPCODE FORMAT | INST. 
LGTH. 


TYPE 
wen [1] rR | 2 | 


Condition Codes 


Mir RESULT =0,SET TOO 











(ADDRESSING C1 PROTECTION 

(CO DATA UNVALID SIGN/DIGIT)] [1 SIGNIFICANCE 

(J DECIMAL DIVIDE CF SPECIFICATION: 

OJ DECIMAL OVERFLOW NOT A FLOATING-POINT REGISTER 
Olexecute - OP 1 NOT ON HALF-WORD BOUNDARY 


DO EXPONENT OVERFLOW OP 2 NOT ON HALF-WORD BOUNDARY 

OC EXPONENT UNDERFLOW OP 2 NOT ON FULL-WORD BOUNDARY 

CO FIXED-POINT DIVIDE OP 2 NOT ON DOUBLE-WORD 

0 FIXED-POINT OVERFLOW BOUNDARY 

C0 FLOATING-POINT DIVIDE OP 1 NOT EVEN NUMBERED REGISTER 

Bi OPERATION OP 1 NOT ODD NUMBERED REGISTER 
NONE 


@ irc REsuLtT <o, set To1 
CIF RESULT > 0, SET TO 2 
(CU1F OVERFLOW, SET TO 3 
(C] UNCHANGED 





The /oad negative, short format (LNER) instruction causes the sign of a full word in the 
operand 2 (r) register to be made negative. The result is placed in a full word in the 
register specified by operand 1 (r,). 


Explicit and Implicit Format: 







A OPERATION A OPERAND 


[symbol] 


LOAD R6,R4 


Operational Considerations: 
= Operand 2 (r2) is made negative even if the fraction is zero. 
# The exponent and fraction are not changed. 
= The contents of operand 2 (r,) remain unchanged. 
m= The condition code is set: 
— to zero if result is zero; and 
— to 1 if result is less than zero. 


Codes 2 and 3 are not used. 
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Example: 
LABEL AOPERATIONA OPERAND 
] 10 16 
LOADNEG LNER R6,R4 


Before execution of the /oad negative, short format (LNER) instruction, if we assume 
values of +150 in R4 and +0 in R6, the contents of R6 and R4 will be: 


R6 before execution: 


R4 before and after execution: 


eee eee], ae 


R6 after execution: 


+0 











UP-8061 Rev. 3 SPERRY UNIVAC OS/3 11-59 
ASSEMBLER 


LPDR 


11.28. LOAD POSITIVE, LONG FORMAT (LPDR) 


Possible Program Exceptions 


[J] ADDRESSING (J PROTECTION 










OBJECT 





























OPCODE 
past he (1 DATA (INVALID SIGN/DIGIT) | [] SIGNIFICANCE 
(BYTES) || LJ DECIMAL DIVIDE CO SPECIFICATION: 










LD DECIMAL OVERFLOW 

[] EXECUTE 

(J EXPONENT OVERFLOW 
(EXPONENT UNDERFLOW 
CJ FIXED-POINT DIVIDE 

CO FIXED-POINT OVERFLOW 
OC) FLOATING-POINT DIVIDE 
@ OPERATION 


NOT A FLOATING-POINT REGISTER 

OP 1 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON FULL-WORD BOUNDARY 


OP 2 NOT ON DOUBLE-WORD 
BOUNDARY 


OP 1 NOT EVEN NUMBERED REGISTER 
OP 1 NOT ODD NUMBERED REGISTER 
NONE 


vor |a{ are | 2 
Condition Codes 


Mic RESULT =0,SET TOO 
Or RESULT <0, SET TO1 
@ ir RESULT >o, SET TO 2 
(U1F OVERFLOW, SET TO 3 
(J UNCHANGED 









OOO OOOO 


The /oad positive, long format (LPDR) instruction causes the sign of the double word in the 
operand 2 (r,) register to be positive, and the result is placed in the double word of the 
operand 1 (r,) register. 


Explicit and Implicit Format: 







A OPERATION A OPERAND 







LPDR 
LPDR 


ry ne) 


R4,R6 





[symbol] 
LOADN 
Operational Considerations: 
= The exponent and fraction are not changed. 
= The contents of operand 2 (r.) remain unchanged. 
= §6The condition code is set: 
— to zero if result is zero; and 


— to 2 if result is greater than zero. 


Codes 1 and 3 are not used. 
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Example: 
LABEL AOPERATIONA OPERAND 
1 10 16 
LOADPOS LPDR R6,R4 


Before execution of the /oad positive, long format (LPDR) instruction, if we assume 
value of —150 in R4 and +0 in R6, the contents of R6 and R4 will be: 


R6 before execution: 


ERS ES Eee Ee 


R4 before and after execution: 


Eee PERSE REE eee 


R6 after execution: 


] 
eae ee ae eee: 
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LPER 


11.29. LOAD POSITIVE, SHORT FORMAT (LPER) 


Possible Program Exceptions 


(I) ADDRESSING DC PROTECTION 

(0 DATA (INVALID SIGN/DIGIT)| 1] SIGNIFICANCE 

C DECIMAL OlvtDE CX] sPECIFICATION: 

OC DECIMAL OVERFLOW NOT A FLOATING-POINT REGISTER 
CJ Execute OP 1 NOT ON HALF-WORD BOUNDARY 
(0 ExPONENT OVERFLOW OP 2 NOT ON HALF-WORD BOUNDARY 
() ExPONENT UNDERFLOW OP 2 NOT ON FULL-WORD BOUNDARY 
CO FIx€D-POINT DIVIDE OP 2 NOT ON DOUBLE-WORD 


CO] FIxED-POINT OVERFLOW BOUNDARY 
1 FLOATING-POINT DIVIDE OP 1 NOT EVEN NUMBERED REGISTER 


a OPERATION OP 1 NOT ODD NUMBERED REGISTER 
NONE 


General 


OBJECT 
OPCODE FORMAT | INST. 
TYPE LGTH. 


MNEM. JHEX, (BYTES) 






























LPER 


Condition Codes 


@ iF RESULT = 0,SET TOO 
Cie RESULT <0, SETTO1 
Wir RESULT > 0, SET TO2 
CJ IF OVERFLOW, SET TO 3 
(J UNCHANGED 


OOO OOOO 





The /oad positive, short format (LPER) instruction causes the sign of a full word in the 
operand 2 (r2) register to be positive. The result is placed in a full word of the operand 1 
(r,;) register. 


Explicit and Implicit Format: 





OPERAND 







A OPERATION A 


[symbol] 


LOADP R6,R4 


Operational Considerations: 
m The exponent and fraction are not changed. 
# The contents of operand 2 (r.) remain unchanged. 
= The condition code is set: 
— to zero if result is zero; and 
— to 2 if result is greater than zero. 


Codes 1 and 3 are not used. 
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Example: 
LABEL AOPERATIONA OPERAND 
] 10 16 
LOADPOS LPER R6,R4 


Before execution of the /oad positive, short format (LPER) instruction, if we assume 
values of —150 in R4 and +0 in R6, the contents of R6 and R4 will be: 


R6 before execution: 


ere] « 
R4 before and after execution: 
R6 after execution: 


ee tes eo eet a] Be 
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LTDR 


11.30. LOAD AND TEST, LONG FORMAT (LTDR) 


Possible Program Exceptions 


rece ADDRESSING C1 PROTECTION 
OPCODE | FoRMAT | INST. 2 
TYPE LGTH. (1 DATA (INVALID SIGN/DIGIT)} [1] SIGNIFICANCE 

MNEM. (Bytes) || () DECIMAL DIVIDE (] SPECIFICATION: 


[sven OJ DECIMAL OVERFLOW NOT A FLOATING-POINT REGISTER 
liron | 22} re | 2 | OO execute - OP 1 NOT ON HALF-WORD BOUNDARY 
OJ EXPONENT OVERFLOW 


OP 2 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON FULL-WORD BOUNDARY 
BM ccesulr =o certo O FIXED-POINT DIVIDE OP 2 NOT ON DOUBLE-WORD 
Bic RESULT <0, SET O94 0 FIXED-POINT OVERFLOW 
Wir RESULT >0, SET TO 2 C] FLOATING-POINT DIVIDE 


BOUNDARY 
OP 1 NOT EVEN NUMBERED REGISTER 

(1F OVERFLOW, SET TO 3 Mi OPERATION 

(J UNCHANGED 


OP 1 NOT ODD NUMBERED REGISTER 
NONE 


a 
O 
0 
O 
O 
O 
0 
O 





The foad and test, long format (LTDR) instruction causes the double-word contents of the 
operand 2 (r.) register to be placed in the double-word operand 1 (r,) register. The 
condition code is set by this instruction. 


Explicit and Implicit Format: 







A OPERATION A OPERAND 


[symbol] 


TEST R2,R6 


Operational Considerations: 
= The contents of operand 2 (r.) remain unchanged. 


= When the same register is specified by operand 1 (r,) and operand 2 (r,), the 
operation is equivalent to a test without data movement. 


a The condition code is set: 
— to zero if result is zero; 
— to 1 if result is less than zero; and 


— to 2 if result is greater than zero. 


Code 3 is not used. 
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Example: 
LABEL AQPERATIONA OPERAND 
1 10 16 
TEST LTDR R2,R6 


Before execution of the /oad and test, long format (LTDR) instruction, if we assume 
values of +150 in R6 and +0 in R2, the contents of R6 and R2 will be: 


R2 before execution: 


Oe Ol) ae peer oat [ory aie od ee ee ees 


R6 before and after execution: 


Ree ee ee ee ee 


R2 after execution: 


Pea ED PERE ee a 


The condition code is set to 2 because the result is greater than zero. 
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LTER 


11.31. LOAD AND TEST, SHORT FORMAT (LTER) 


Possible Program Exceptions 


[] ADDRESSING CO] PROTECTION 

C1 DATA (INVALID SIGN/DIGIT) | (] SIGNIFICANCE 

(J DECIMAL DIVIDE OO) SPECIFICATION: 

(J DECIMAL OVERFLOW NOT A FLOATING-POINT REGISTER 
0 execute OP 1 NOT ON HALF-WORD BOUNDARY 
CL) EXPONENT OVERFLOW OP 2 NOT ON HALF-WORD BOUNDARY 
C0 EXPONENT UNDERFLOW OP 2 NOT ON FULL-WORD BOUNDARY 
CD FIXED-POINT DIVIDE OP 2 NOT ON DOUBLE-WORD 


D FIXED-POINT OVERFLOW BOUNDARY 
(7 FLOATING-POINT DIVIDE OP 1 NOT EVEN NUMBERED REGISTER 


W8 OPERATION oP 1 NOT ODD NUMBERED REGISTER 
NONE 


OBJECT 
OPCODE FORMAT | INST. 


TYPE LGTH. 


wen fel m [2 _| 


Condition Codes 


Mit RESULT =0,SET TOO 
Wir RESULT <0, SETTO1 
Mir RESULT > 0, SET TO2 
CIF OVERFLOW, SET TO 3 
(J UNCHANGED 











B 
O 
QO 
O 
O 
O 
0 
O 





The /oad and test, short format (LTER) instruction causes the contents of a full word in the 
operand 2 (r,) register to be placed in a full word in the operand 1 (r,) register. The 
condition code is set by this instruction. 


Explicit and Implicit Format: 







A OPERATION A OPERAND 


[symbol] 


TEST R6,R4 


Operational Considerations: 
= The contents of operand 2 (r.) remain unchanged. 


= ~=When the same register is specified by operand 1 (r,;) and operand 2 (r,) the operation 
is equivalent to a test without data movement. 


a The condition code is set: 
— to zero if result is zero; 
— to 1 if result is less than zero; and 


— to 2 if result is greater than zero. 


Code 3 is not used. 
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Example: 
LABEL AOPERATIONA OPERAND 
] 10 16 
TEST LTER R6,R4 


Before execution of the /oad and test, short format (LTER) instruction, if we assume 
values of +150 in R4 and +0 in R6, the contents of R4 and R6 will be: 


R6 before execution: 


R4 before and after execution: 


R6 after execution: 


The condition code is set to 2 because the result is greater than zero. 


é 


+150 
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MD 


11.32. MULTIPLY, LONG FORMAT (MD) 


OBJECT || gy ADDRESSING W@ PROTECTION 
oaks C1 PATA (INVALID SIGN/DIGIT) | [] SIGNIFICANCE 
(By TES) || DJ DECIMAL DiviDE CO SPECIFICATION: 
DC DECIMAL OVERFLOW NOT A FLOATING-POINT REGISTER 


OC &xecuTe OP 1 NOT ON HALF-WORD BOUNDARY 
Condition Codes 


EXPONENT OVERFLOW OP 2 NOT ON HALF-WORD BOUNDARY 
Clif RESULT =0,SET TOO 









OPCODE | FORMAT 
TYPE 











MNEM. ]HEX, 


EXPONENT UNDERFLOW OP 2 NOT ON FULL-WORD BOUNDARY 
OC FIXED-POINT DIVIDE OP 2 NOT ON DOUBLE-WORD 

C F1xXED-POINT OVERFLOW BOUNDARY 

C0 FLOATING-POINT DIVIDE OP 1 NOT EVEN NUMBERED REGISTER 
OPERATION OP 1 NOT ODD NUMBERED REGISTER 
NONE 


Clit RESULT <0, SET TO1 
Citrt RESULT > 0, SET TO2 
Ci tF OVERFLOW, SET TO 3 
BB UNCHANGED 


OOO gOoo8 





The multiply, long format (MD) instruction causes the contents of the double word in the 
operand 1 (r,) register to be multiplied by the contents of a double word in main storage 
specified by operand 2. The normalized product is placed in the double word of the 
operand 1 (r,) register. 


Explicit Format: 








LABEL A OPERATION A OPERAND 





[symbol] 
MULT 


r, id, (x, b, ) 
R4,32(R9,R10) 


Implicit Format: 







LABEL AOPERATION A 





OPERAND 


[symbol] 


MULT R4,FAM 


Operational Considerations: 


a Floating-point multiplication consists of exponent addition and fraction multiplication. 
The exponent of the intermediate product is obtained by adding the exponents of the 
two operands and reducing the sum by 64. 
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= Both operands are normalized before multiplication and the intermediate product is é 
normalized after multiplication. The intermediate product fraction is truncated to 14 
digits and a guard digit before normalization. 


= If the exponent of the final product exceeds 127, an exponent overflow condition 
exists. The resultant floating-point number consists of a correct and normalized 
fraction, a correct sign, and an exponent which is 128 less than the correct value. 
The overflow condition does not occur for an intermediate product exponent 
exceeding 127 if.the final exponent is brought within range during normalization. 


a If the final product exponent is less than zero, an exponent underflow condition 
exists. If the exponent underflow mask bit (38) of the current PSW is 1, the resultant 
floating-point number has a correct and normalized fraction, a correct sign, and an 
exponent which is 128 greater than the correct value. If the exponent underflow mask 
bit of the current PSW is zero, the result is made a true zero. When an underflow 
characteristic becomes less than zero during normalization before multiplication, an 
underflow exception is not recognized. 


= When all digits of the intermediate product are zero, the result is made a true zero. 


= When the resulting fraction is zero, a program exception for exponent underflow or 
overflow does not occur. 








Example: 
LABEL AOPERATIONA OPERAND 
1 10 16 
MULTLG MD R4 FAM 
FAM oc D'59' 


Before execution of the multiply, long format (MD) instruction, if we assume a value 
of -100 in R4, the contents of R4 and main storage area FAM will be: 


R4 before execution: 


foe BS fA] sae org ee) a eee ee eae 


FAM before and after execution: 


ees ee Oa [ay oa er ee eel oe a 


R4 after execution: 


eoiilslete lege ele fe fecjen “@ 
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11.33. MULTIPLY, LONG FORMAT (MDR) 


Possible Program Exceptions 


OBJECT || 7 ADDRESSING C1 PROTECTION 


OPCODE | FORMAT | INST. 
TRE flere: [0 DATA (INVALID SIGN/DIGIT)| [) SIGNIFICANCE 


(Bytes) || DJ DECIMAL Divide CL) SPECIFICATION: 


OC DECIMAL OVERFLOW 


NOT A FLOATING-POINT REGISTER 

OP 1 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON FULL-WORD BOUNDARY 


OP 2 NOT ON DOUBLE-WORD 
BOUNDARY 


OP 1 NOT EVEN NUMBERED REGISTER 
OP 1 NOT ODD NUMBERED REGISTER 
NONE 


@ EXPONENT OVERFLOW 
@@ EXPONENT UNDERFLOW 
Olif RESULT =0,SET TOO C] FIXED-POINT DIVIDE 
Clit RESULT <0, SETTO1 0 FixeD-POINT OVERFLOW 
Clif RESULT > 0, SET TO 2 DD FLOATING-POINT DIVIDE 


CIF OVERFLOW, SET TO 3 HB OPERATION 
BE UNCHANGED 


OOO OOOO 





The multiply, long format (MDR) instruction causes the contents of the double word in the 
operand 1 (r,) register to be multiplied by the contents of the double word in the operand 2 
(r.) register. The normalized product is placed in the double word of the operand 1 (r;) 
register. 


Explicit and Implicit Format: 


A OPERATION A OPERAND 





Operational Considerations: 


# Floating-point multiplication consists of exponent addition and fraction multiplication. 
The exponent of the intermediate product is obtained by adding the exponents of the 
two operands and reducing the sum of 64. 


= Both operands are normalized before multiplication and the intermediate product is 
normalized after multiplication. The intermediate product fraction is truncated to 14 
digits and a guard digit before normalization. 
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= If the exponent of the final product exceeds 127, an exponent overflow condition 
exists. The resultant floating-point number consists of a correct and normalized 
fraction, a correct sign, and an exponent which is 128 less than the correct value. 
The overflow condition does not occur for an intermediate product exponent 
exceeding 127 if the final exponent is brought within range during normalization. 





a If the final product exponent is less than zero, an exponent underflow condition 
exists. If the exponent underflow mask bit (38) of the current PSW is 1, the resultant 
floating-point number has a correct and normalized fraction, a correct sign, and an 
exponent which is 128 greater than the correct value. If the exponent underflow mask 
bit of the current PSW is zero, the result is made a true zero. When an underflow 
characteristic becomes less than zero during normalization before multiplication, an 
underflow exception is not recognized. 


= When ail digits of the intermediate product are zero, the result is made a true zero. 


= When the resulting fraction is zero, a program exception for exponent underflow or 
overflow does not occur. 











Example: 
LABEL AOPERATIONA OPERAND 
| 10 16 
MULTREG MDR R4 ,R6 


Before execution of the multiply, long format (MDR) instruction if we assume values 
of —100 in R4 and +50 in R6, the contents of R4 and R6 will be: 


R4 before execution: 


Rc RRS Ee A 


R6 before and after execution: 


R4 after execution: 


er Tee epee ee pe] 
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@ ME 


11.34. MULTIPLY, SHORT FORMAT (ME) 


General 


OBJECT 


OPCODE FORMAT | INST. 
LGTH. 


TYPE 
NEM (av TES) 


Condition Codes 


Cif RESULT = 0,SET TOO 
Ctr RESULT <0, SET TO1 
Ott RESULT > 0, SET TO 2 
CIF OVERFLOW, SET TO3 
BB UNCHANGED 


Possible Program Exceptions 


@ ADDRESSING WB PROTECTION 

C0 DATA (INVALID SIGN/DIGIT) | [] SIGNIFICANCE 
( DECIMAL DIVIDE DD sPECIFICATION: 
C DECIMAL OVERFLOW 
@ execute 


















NOT A FLOATING-POINT REGISTER 
OP 1 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON FULL-WORD BOUNDARY 
OP 2 NOT ON DOUBLE-WORD 
BOUNDARY 
OP 1 NOT EVEN NUMBERED REGISTER 
OP 1 NOT ODD NUMBERED REGISTER 
NONE 





@ EXPONENT OVERFLOW 
1 EXPONENT UNDERFLOW 
C0 FIXED-POINT DIVIDE 

OD FIXED-POINT OVERFLOW 
0 FLOATING-POINT DIVIDE 
@ OPERATION 








OOO O8OOG 





The multiply, short format (ME) instruction causes the contents of a full word in the 
operand 1 (r,) register to be multiplied by the contents of a full word in main storage 
specified by operand 2. The normalized product is placed in a full word of the operand 1 


@ (r,) register. 


Explicit Format: 






A OPERATION A OPERAND 






ry dy (x, b,) 
R6,32(R8,R12) 


[symbol] 
MULT 


Implicit Format: 


A OPERATION A OPERAND 





Operational Considerations: 


# Floating-point multiplication consists of exponent addition and fraction multiplication. 
& The exponent of the intermediate product is obtained by adding the exponents of the 
two operands and reducing the sum by 64. 
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. Both operands are normalized before multiplication and the intermediate product is 
normalized after multiplication. The intermediate product fraction is truncated to 14 
digits, the two least significant digits of which are zero, before normalization. 


= If the exponent of the final product exceeds 127, an exponent overflow condition 
exists. The resultant floating-point number consists of a correct and normalized 
fraction, a correct sign, and an exponent which is 128 less than the correct value. 
The overflow condition does not occur for an intermediate product exponent 
exceeding 127 if the final exponent is brought within range during normalization. 


= If the final product exponent is less than zero, an exponent underflow condition 
exists. If the exponent underflow mask bit (38) of the current PSW is 1, the resultant 
floating-point number has a correct and normalized fraction, a correct sign, and an 
exponent which is 128 greater than the correct value. If the exponent underflow mask 
bit of the current PSW is zero, the result is made a true zero. When an underflow 
characteristic becomes less than zero during normalization before multiplication, an 
underflow exception is not recognized. 


= When all digits of the intermediate product are zero, the result is made a true zero. 


= When the resulting fraction is zero, a program exception exponent underflow or 
overflow does not occur. 








Example: 
LABEL AOPERAT IONA OPERAND 
1 10 16 
MULT ME R6,FAM 
FAM DC E'5g' 


Before execution of the multiply, short format (ME) instruction, if we assume a value 
of —100 in R6, the contents of R6 and main storage area FAM will be: 


R6 before execution: 


FAM before and after execution: 





cte|[ats|[etepo te] -s0m 
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MER 


11.35. MULTIPLY, SHORT FORMAT (MER) 


OBJECT || 7 ADDRESSING C1 PROTECTION 






































OPCODE i sae 
pone. aan [J DATA UNVALID SIGN/DIGIT) | [J SIGNIFICANCE 
(BYTES) || L) DECIMAL DiviDE CO SPECIFICATION: 










[CD DECIMAL OVERFLOW 

OO Execute 

EXPONENT OVERFLOW 
EXPONENT UNDERFLOW 
OO FIXED-POINT DIVIDE 

C0 FIxED-POINT OVERFLOW 
(J FLOATING-POINT DIVIDE 
W OPERATION 


NOT A FLOATING-POINT REGISTER 

OP 1 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON FULL-WORD BOUNDARY 


OP 2 NOT ON DOUBLE-WORD 
BOUNDARY 


OP 1 NOT EVEN NUMBERED REGISTER 
OP 1 NOT ODD NUMBERED REGISTER 
NONE 


Condition Codes 


CJ iF RESULT = 0,SET TOO 


Cte RESULT <0, SETTO1 
Cif RESULT >0, SET TO 2 
CIF OVERFLOW, SET TO 3 
MB UNCHANGED 


OOO OOOO 





The multiply, short format (MER) instruction causes the contents of a full word in the 
operand 1 (r,) register to be multiplied by the contents of a full word in the operand 2 (r.) 
register. The normalized product is placed in a full word in the operand 1 (r,) register. 


Explicit and Implicit Format: 







AOPERATION A OPERAND 
[symbol] 


MULT R6,R4 


Operational Considerations: 


# Floating-point multiplication consists of exponent addition and fraction multiplication. 
The exponent of the intermediate product is obtained by adding the exponents of the 
two operands and reducing the sum by 64. 


= Both operands are normalized before multiplication and the intermediate product is 
normalized after multiplication. The intermediate product fraction is truncated to 14 
digits, the two least significant digits of which are zero, before normalization. 


= If the exponent of the final product exceeds 127, an exponent overflow condition 
exists. The resultant floating-point number consists of a correct and normalized 
fraction, a correct sign, and an exponent which is 128 less than the correct value. 
The overflow condition does not occur for an intermediate product exponent 
exceeding 127 if the final exponent is brought within range during normalization. 
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a If the final product exponent is less than zero, an exponent underflow condition 
exists. If the exponent underflow mask bit (38) of the current PSW is 1, the resultant 
floating-point number has a correct and normalized fraction, a correct sign, and an 
exponent which is 128 greater than the correct value. If the exponent underflow mask 
bit of the current PSW is zero, the result is made a true zero. When an underflow 
characteristic becomes less than zero during normalization before multiplication, an 
underflow exception is not recognized. 


= When all digits of the intermediate product are zero, the result is made a true zero. 


= When the resulting fraction is zero, a program exception for exponent underflow or 
overflow does not occur. 





Example: 
LABEL AOPERATIONA OPERAND 
] 10 16 
MULT MER R6,R4 


Before execution of the multiply, short format (MER) instruction, if we assume values 
of —100 in R6 and +50 in R4, the contents of R6 and R4 will be: 


R6 before execution: 





R4 before and after execution: 


t 
ci 4] 1t3 sis {oto | —500 





UP-8061 Rev. 3 SPERRY UNIVAC OS/3 11-75 
ASSEMBLER 


SD 


11.36. SUBTRACT NORMALIZED, LONG FORMAT (SD) 


OBJECT 


OPCODE FORMAT | INST. 
LGTH. 


TYPE 


Condition Codes 


M if RESULT =0,SET TOO 
















MM ADDRESSING W@ PROTECTION 

(] DATA (INVALID SIGN/DIGIT) | I SIGNIFICANCE 
CO DECIMAL DIVIDE CO SPECIFICATION: 
CJ DECIMAL OVERFLOW 
O execute 





NOT A FLOATING-POINT REGISTER 

OP 1 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON FULL-WORD BOUNDARY 


OP 2 NOT ON DOUBLE-WORD 
BOUNDARY 


OP 1 NOT EVEN NUMBERED REGISTER 
OP 1 NOT ODD NUMBERED REGISTER 
NONE 


IB EXPONENT OVERFLOW 
EXPONENT UNDERFLOW 
C1 FIXED-POINT DIVIDE 

0 FIXED-POINT OVERFLOW 
C0 FLOATING-POINT DIVIDE 
BE OPERATION 


Mir Resutt <o, set To 1 
Wir RESULT >0O, SET TO 2 
(CJ 1F OVERFLOW, SET TO 3 
CJ UNCHANGED 





OOO 8OOO8 





The subtract normalized, long format (SD) instruction causes the contents of a double 
word in main storage, specified by operand 2, to be algebraically subtracted from the 
contents of the double word register specified by operand 1 (r,). The normalized difference 
is placed in the operand 1 (r,) register. 


Explicit Format: 





A OPERATION A OPERAND 






Yr, dd, (x, iby ) 
R4,32(R7,R8) 


Implicit Format: 


A OPERATION A OPERAND 
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Operational Considerations: @ 


= = The execution of the SD instruction is identical to that of the AD instruction (11.2), 
except that the sign of operand 2 is reversed before addition. 


= The condition code is set: 
— to zero if result fraction is zero; 
— to 1 if result fraction is less than zero; and 
— to 2 if result fraction is greater than zero. 


Code 3 is not used. 


Example: 
LABEL AOPERAT !ONA OPERAND 
! 10 16 
SUBLONG SD R4, FAM 
FAM DC D'1G9' 





Before execution of the subtract normalized, long format (SD) instruction if we 
assume a value of +250 in R4, the contents of R4 and main storage area FAM will 
be: 


R4 before execution: 


Riess eRe eee Ree 


FAM before and after execution: 


Ese ses ER ES See ERE ee 


R4 after execution: 
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SDR 


11.37. SUBTRACT NORMALIZED, LONG FORMAT (SDR) 


General Possible Program Exceptions 
OBJECT 
ADDRESSING CO PROTECTION 
OPCODE FORMAT | INST. O 
TYPE LGTH. 


(J DATA (INVALID SIGN/DIGIT) @ SIGNIFICANCE 
MNEM. (BYTES) 


| winem. | (C0 DECIMAL DIVIDE C0 SPECIFICATION: 
[son [ze[ ar | 2 | OJ DECIMAL OVERFLOW NOT A FLOATING-POINT REGISTER 
Condition Codes 


(] execute OP 1 NOT ON HALF-WORD BOUNDARY 
W@ EXPONENT OVERFLOW OP 2 NOT ON HALF-WORD BOUNDARY 
@ exPONENT UNDERFLOW OP 2 NOT ON FULL-WORD BOUNDARY 
Bia ececrio C0 FIXED-POINT DIVIDE OP 2 NOT ON DOUBLE-WORD 
Bir RESULT <0, SET eA UJ FIXED-POINT OVERFLOW BOUNDARY 
BE if RESULT > 0, SET TO2 
CF OVERFLOW, SET TO3 
CJ UNCHANGED 






























C0 FLOATING-POINT DIVIDE OP 1 NOT EVEN NUMBERED REGISTER 
1] @ OPERATION OP 1 NOT ODD NUMBERED REGISTER 
NONE 







OOO OOOO 


The subtract normalized, long format (SDR) instruction causes the contents of the double- 
word register, specified by operand 2 (r2) to be algebraically subtracted from the contents 
of the double-word register, specified by operand 1 (r,). The normalized difference is 
placed in the operand 1 (r,) register. 


Explicit and Implicit Format: 








A OPERATION A OPERAND 


[symbol] 


SUBTR R6,R4 


Operational Considerations: 


= The execution of the SDR instruction is identical to that of the ADR instruction (11.3), 
except that the sign of operand 2 (r.) is reversed before addition. 


a The condition code is set: 
— to zero if result fraction is zero; 
— to 1 if result fraction is less than zero; and 


— to 2 if result fraction is greater than zero. 


Code 3 is not used. 





UP-8061 Rev. 3 SPERRY UNIVAC OS/3 11-78 








ASSEMBLER 
Example: 
LABEL. AOPERATIONA OPERAND 
1 10 16 
SUBTR SDR R6,R4 


Before execution of the subtract normalized, long format (SDR) instruction, if we 
assume values of +250 in R6 and +100 in R4, the contents of R6 and R4 will be: 


R6 before execution: 


R4 before and after execution: 


OT Oe eee ee Oe eee 


R6 after execution: 


Pees Cee ere eee a Ee @ 
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SE 


11.38. SUBTRACT NORMALIZED, SHORT FORMAT (SE) 


General Possible Program Exceptions 
OBJECT ADDRESSING 
OPCODE FORMAT | INST. a 
TYPE LGTH. 


(J DATA (INVALID SIGN/DIGIT) 
MNEM. (BYTES) 


| minem. | (J DECIMAL DiviDE 
0 DECIMAL OVERFLOW 
| se |r] rx | 4 | 
Condition Codes 


OJ Execute 
EXPONENT OVERFLOW 
Mir RESULT = 0,SET TOO 
Wir Resuct <o,setto1 


Ml EXPONENT UNDERFLOW 
BB if RESULT >O, SET TO2 


( FIXED-POINT DIVIDE 

CO FIXED-POINT OVERFLOW 
CIF OVERFLOW, SET TO 3 
[C] UNCHANGED 






















MW PROTECTION 

HB SIGNIFICANCE 

DJ SPECIFICATION: 

NOT A FLOATING-POINT REGISTER 
OP 1 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON FULL-WORD BOUNDARY 


OP 2 NOT ON DOUBLE-WORD 
BOUNDARY 


OP 1 NOT EVEN NUMBERED REGISTER 
OP 1 NOT ODD NUMBERED REGISTER 
NONE 



























OJ FLOATING-POINT DIVIDE 
WB OPERATION 


OOO O8 OOS 


The subtract normalized, short format (SE) instruction causes the contents of a full word in 
main storage, specified by operand 2, to be algebraically subtracted from a full word in the 


register specified by operand 1 (r,). The normalized difference is placed in the operand 1 
(r,) register. 


Explicit Format: 







A OPERATION A OPERAND 






rd (x, ,b,) 


SUB R2,32(R9,R10) 


Implicit Format: 


AOPERATION A OPERAND 
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Operational Considerations: 


m= = §=€6The execution of the SE instruction is identical to that of the AE instruction (11.4), 
except that the sign of operand 2 is reversed before addition. 


= §=©The condition code is set: 
— to zero if result fraction is zero; 
— to 1 if result fraction is less than zero; and 
— to 2 if result fraction is greater than zero. 


Code 3 is not used. 





Example: 
LABEL AOPERATIONA OPERAND 
1 10 16 
SUBSHORT SE R2,FAM 
FAM oc E'1gg' 


Before execution of the subtract normalized, short format (SE) instruction, if we 
assume a value of +250 in R2, the contents of R2 and main storage area FAM will 


be: 





R2 before execution: 


FAM before and after execution: 


R2 after execution: 
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SER 


11.39. SUBTRACT NORMALIZED, SHORT FORMAT (SER) 


Possible Program Exceptions 


OBJSECT 


ADDRESSING CJ PROTECTION 
OPCODE FORMAT | INST. O 


(CJ DATA (INVALID SIGN/DIGIT) | J SIGNIFICANCE 
(0 DECIMAL DIVIDE (CO SPECIFICATION: 
0 DECIMAL OVERFLOW 
OO execute 


TYPE LGTH. 
MNEM. JHEX, (BYTES) 


Condition Codes 


WM if RESULT = 0,SET TOO 
Wir Result <o,sETTO1 
BBiF RESULT > 0, SET TO 2 
CitF OVERFLOW, SET TO 3 
(CJ UNCHANGED 


NOT A FLOATING-POINT REGISTER 
OP 1 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON FULL-WORD BOUNDARY 
OP 2 NOT ON DOUBLE-WORD 
BOUNDARY 
OP 1 NOT EVEN NUMBERED REGISTER 
OP 1 NOT ODD NUMBERED REGISTER 
NONE 





W EXPONENT OVERFLOW 
EXPONENT UNDERFLOW 
(1 FIXED-POINT DIVIDE 

0 FIxXED-POINT OVERFLOW 
DD FLOATING-POINT DIVIDE 
BB OPERATION 







OOO OOOOS 





The subtract normalized, short format (SER) instruction causes the contents of a full word 
in the operand 2 (r,) register to be algebraically subtracted from a full word in the operand 
1 (r;). The normalized difference is placed in a full word in the operand 1 (r,) register. 


Explicit and Implicit Format: 


A OPERATION A OPERAND 





Operational Considerations: 


= ~§=©The execution of the SER instruction is identical to that of the AER instruction (11.5), 
except that the sign of operand 2 is reversed before addition. 


= The condition code is set: 
— to zero if result fraction is zero; 
— to 1 if result fraction is less than zero; and 
— to 2 if result fraction is greater than zero. 


Code 3 is not used. 
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Example: 
LABEL AOPERAT I ONA OPERAND 
| 10 16 
SUB SER R2,R4 


Before execution of the subtract normalized, short format (SER) instruction, if we 
assume values of +250 in R2 and +100 in R4, the contents of R2 and R4 will be: 


R2 before execution: 


R4 before and after execution: 
R2 after execution: 




















UP-8061 Rev. 3 SPERRY UNIVAC OS/3 11-83 
ASSEMBLER 


STD 


11.40. STORE, LONG FORMAT (STD) 


General Possible Program Exceptions 
OBJECT 
ADDRESSING WB PROTECTION 
OPCODE FORMAT | INST. 5 
TYPE LGTH. 


(0 DATA (INVALID SIGN/DIGIT) | [] SIGNIFICANCE 
MNEM. JHEX, (BYTES) 


| mivem. | [1] DECIMAL DiviDE OO sPeciFICATION: 
(C] DECIMAL OVERFLOW NOT A FLOATING-POINT REGISTER 
| sto joo] vx | a | 
Condition Codes 


OJ execute OP 1 NOT ON HALF-WORD BOUNDARY 
OF RESULT = 0,SET TOO 












C1 EXPONENT OVERFLOW OP 2 NOT ON HALF-WORD BOUNDARY 
(0 EXPONENT UNDERFLOW OP 2 NOT ON FULL-WORD BOUNDARY 
C1 FIXED-POINT DIVIDE OP 2 NOT ON DOUBLE-WORD 

C] FIXED-POINT OVERFLOW BOUNDARY 

C] ELOATING-POINT DIVIDE OP 1 NOT EVEN NUMBERED REGISTER 
OPERATION OP 1 NOT ODD NUMBERED REGISTER 

NONE 


Olir RESULT <0, SETTO1 
Dif RESULT > 0, SET TO 2 
CIF OVERFLOW, SET TO3 
BBUNCHANGED 


OOO gOOCO® 





The store, long format (STD) instruction causes the contents of the register, specified by 
operand 1 (r,), to be placed in a double word in main storage, specified by operand 2. 


Explicit Format: 







AOPERATION A OPERAND 


[symbol] 
STORE 


r, a, (x, .b, ) 
R4,32(R5,R6) 


Implicit Format: 







A OPERATION A OPERAND 


[symbol] 


STORE R4,FAM 


Operational Consideration: 


a The contents of the operand 1 (r,) register remain unchanged. 
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Example: 
LABEL AQPERATIONA OPERAND 
1 10 16 
STORELG STD R4 FAM 
FAM DC D'g' 


Before execution of the store, long format (STD) instruction, if we assume a value of 
+500 in R4, the contents of R4 and main storage area FAM will be: 


FAM before execution: 


EE cs ee RPE SER CA ee 


R4 before and after execution: 


ERE EEA Peer 


FAM after execution: 


Eats oe Re eee a 
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6 STE 


11.41. STORE, SHORT FORMAT (STE) 


Possible Program Exceptions 


fi ADDRESSING W@ PROTECTION 









OBJECT 






















OPCODE 
patie pes (DATA (INVALID SIGN/DIGIT)| [) SIGNIFICANCE 
(sytes) || D) DECIMAL DiviDE OC sPeciFicaTion: 










OJ DECIMAL OVERFLOW 

() Execute 

CL] EXPONENT OVERFLOW 
C1 EXPONENT UNDERFLOW 
OD) FIXED-POINT DIVIDE 

CO FIxXeD-POINT OVERFLOW 
C1 FLOATING-POINT DIVIDE 
BM OPERATION 


NOT A FLOATING-POINT REGISTER 

OP 1 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON FULL-WORD BOUNDARY 


OP 2 NOT ON DOUBLE-WORD 
BOUNDARY 


OP 1 NOT EVEN NUMBERED REGISTER 
OP 1 NOT ODD NUMBERED REGISTER 
NONE 


| ste {m{ ex | « | 
Condition Codes 


Olie RESULT = 0,SET TOO 
Die RESULT <0, SET TO1 
CF RESULT >0O, SET TO 2 
DOF OVERFLOW, SET TO3 
HEUNCHANGED 







OOO O80O@ 





The store, short format (STE) instruction causes the contents of a full word in the register, 


specified by operand 1 (r,) to be placed in a full word in main storage, specified by operand 
2. 


Explicit Format: 






AOPERATION A OPERAND 






[symbol] 
STORE 


rd, (x, ,b5) 
R4,32(R5,R6) 





Implicit Format: 







A OPERATION A OPERAND 


[symbol] 


STORE R4,FAM 


Operational Consideration: 


a The contents of the operand 1 (r,) register remain unchanged. 
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Example: 
LABEL AOPERATIONA OPERAND 
! 10 16 
STORE STE R4 , FAM 
FAM DC E'g' 


Before execution of the store, short format (STE) instruction, if we assume a value of 
+500 in R4, the contents of R4 and main storage FAM will be: 


FAM before execution: 


FAM after execution: 


+500 
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11.42. SUBTRACT UNNORMALIZED, SHORT FORMAT (SU) 


Possible Program Exceptions 
OPCODE | FORMAT 
TYPE 

































ae 






ADDRESSING Wi PROTECTION 














eee (J DATA (INVALID SIGN/DIGIT) HB SIGNIFICANCE 
MNEM., (BYTES) (1 DECIMAL DIVIDE (0 sPEcIFICATION: 


DC DECIMAL OVERFLOW 

CO] execute 

@ EXPONENT OVERFLOW 
(1 EXPONENT UNDERFLOW 
( FIX€ED-POINT DIVIDE 

OJ FIXED-POINT OVERFLOW 
C1 FLOATING-POINT DIVIDE 
OPERATION 


NOT A FLOATING-POINT REGISTER 

OP 1 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON FULL-WORD BOUNDARY 


OP 2 NOT ON DOUBLE-WORD 
BOUNDARY 


OP 1 NOT EVEN NUMBERED REGISTER 
OP 1 NOT ODD NUMBERED REGISTER 
NONE 


Condition Codes 


WM iF RESULT =0,SET TOO 
Wir Resuct <o, set To1 
Wir RESULT >0O, SET TO 2 
O1F OVERFLOW, SET TO 3 
CI UNCHANGED 





















OOO O8OO8 





The subtract unnormalized, short format (SU) instruction causes the contents of a full 
word in main storage specified by operand 2 to be algebraically subtracted from the 
: contents of a full word in the register specified by operand 1 (r,). The difference is placed 


in a full word in the operand 1 (r,) register. 


Explicit Format: 







AOPERATION A OPERAND 


[symbol] 
SUB 


R6,32(R7,R9) 


Implicit Format: 







AOPERATION A OPERAND 


[symbol] 


SUB R6,FAM 


Operational Considerations: 


a The execution of the SU instruction is identical to that of the AU instruction (11.6), 
@ except that the sign is reversed before addition. 
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= ~=6©The condition code is set: 
— to zero if result fraction is zero; 
— to 1 if result fraction is less than zero; and 
— to 2 if result fraction is greater than zero. 


Code 3 is not used. 





Example: 
LABEL AOPERATIONA OPERAND 
1 10 16 
SUBUNNOR SU R6,FAM 
FAM DC E'90p' 


Before execution of the subtract unnormalized, short format (SU) instruction, if we 
assume a value of +1000 in R6, the contents of R6 and main storage area FAM will 
be: 


R6 before execution: 


sy 


FAM before and after execution: 


t 


+1000 


R6 after execution: 


+100 
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11.43. SUBTRACT UNNORMALIZED, SHORT FORMAT (SUR) 


Possible Program Exceptions 
OBJECT 
OPCODE FORMAT | INST. 
TYPE LGTH. 
MNEM. (BYTES) 


(J ADDRESSING CJ PROTECTION 

(J DATA (INVALID SIGN/DIGIT) f SIGNIFICANCE 

(1) DECIMAL DIVIDE W@ SPECIFICATION: 

(J DECIMAL OVERFLOW NOT A FLOATING-POINT REGISTER 
OJ execute OP 1 NOT ON HALF-WORD BOUNDARY 


Condition Codes 





W@ EXPONENT OVERFLOW OP 2 NOT ON HALF-WORD BOUNDARY 
(EXPONENT UNDERFLOW OP 2 NOT ON FULL-WORD BOUNDARY 
DO FIXED-POINT DIVIDE OP 2 NOT ON DOUBLE-WORD 


0 FixED-POINT OVERFLOW BOUNDARY 
CJ FLOATING-POINT DIVIDE OP 1 NOT EVEN NUMBERED REGISTER 


Wl OPERATION OP 1 NOT ODD NUMBERED REGISTER 
NONE 





@ ir RESULT = 0, SET TOO 
Wir RESULT <o, SET TO1 
@ ir RESULT > 0, SET TO 2 
LJ iF OVERFLOW, SET TO 3 
LI UNCHANGED 







The subtract unnormalized, short format (SUR) instruction causes the contents of a full 
word in the operand 2 (r.) register to be algebraically subtracted from a full word in the 
operand 1 (r,) register. The difference is placed in a full word in the operand 1 (r,) register. 


Explicit and Implicit Format: 


AOPERATIONA OPERAND 





Operational Considerations: 


ws The execution of the SUR instruction is identical to that of the AUR instruction (11.7), 
except that the sign is reversed before addition. 


s The condition code is set: 
— to zero if result fraction is zero; 
— to 1 if result fraction is less than zero; and 
— to 2 if result fraction is greater than zero. 


Code 3 is not used. 





UP-8061 Rev. 3 SPERRY UNIVAC 0S/3 11-90 


ASSEMBLER 
Example: 
LABEL AOPERATIONA OPERAND 
] 10 16 
SUBSHORT SUR R6,R4 


Before execution of the subtract unnormalized, short format (SUR) instruction, if we 
assume values of +1000 in R6 and +900 in R4, the contents of R6 and R4 will be: 


R6 before execution: 


R6 after execution: 


i Ree ee 
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11.44. SUBTRACT UNNORMALIZED, LONG FORMAT (SW) 


Possible Program Exceptions 


HE ADDRESSING 



















OBJECT 







PROTECTION 















OPCODE 
seclti a Hele C1 DATA (INVALID SIGN/DIGIT) | I SIGNIFICANCE 
(Bytes) || C) DECIMAL DIVIDE (CO sPeciFICATION: 










OO DECIMAL OVERFLOW 

0 Execute 

EXPONENT OVERFLOW 
(CO EXPONENT UNDERFLOW 
CJ FIXED-POINT DIVIDE 

CJ FIxXED-POINT OVERFLOW 
C] FLOATING-POINT DIVIDE 
BB OOPERATION 


NOT A FLOATING-POINT REGISTER 

OP 1 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON FULL-WORD BOUNDARY 


OP 2 NOT ON DOUBLE-WORD 
BOUNDARY 


OP 1 NOT EVEN NUMBERED REGISTER 
OP 1 NOT ODD NUMBERED REGISTER 
NONE 


Condition Codes 


iF RESULT = 0,SET TOO 
Wir Resutt <o, set To1 
Mir RESULT > 0, SET TO2 
CIF OVERFLOW, SET TO 3 
(J UNCHANGED 







OOO gOOOg 


The subtract unnormalized, long format (SW) instruction causes the contents of a double 
word in main storage specified by operand 2 to be algebraically subtracted from the 
contents of the double word in the register specified by operand 1 (r,). The difference is 
placed in the double word operand 1 (r,) register. 


Explicit Format: 








A OPERATION A OPERAND 


[symbol] 
SUB 


r, d,(x,,b, ) 
R4,32(R5,R9) 


Implicit Format: 





A OPERATION A OPERAND 


4 Sq (xy) 
R4,FAM 
Operational Considerations: 


= The execution of the SW instruction is identical to that of the AW instruction (11.8), 
except that the sign is reversed before addition. 
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The condition code is set: 

— to zero if result fraction is zero; 

— to 1 if result fraction is less than O; and 
— to 2 if result fraction is greater than zero. 


Code 3 is not used. 


Example: 


LABEL AOPERATIONA OPERAND 
1 10 16 





SUBUNNOR SW R4,FAM 
FAM DC D'966' 


Before execution of the subtract unnormalized, long format (SW) instruction, if we 
assume a value of +1000 in R4, the contents of R4 and main storage area FAM will 
be: 


R4 before execution: 


BREA ES CORSE Re Re ee 


FAM before and after execution: 


Raa Rae Sea eee 


R4 after execution: 


ExEe CoP e Ree a 
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SWR 


11.45. SUBTRACT UNNORMALIZED, LONG FORMAT (SWR) . 





OBJECT 
OPCODE 










[J ADDRESSING 










FORMAT | INST. 
TYPE LGTH. C] DATA (INVALID SIGN/DIGIT) 
MNEM. (BYTES) (J DECIMAL DivIDE 








OJ DECIMAL OVERFLOW 
OD execute 

EXPONENT OVERFLOW 
1 EXPONENT UNDERFLOW 






Condition Codes 






Possible Program Exceptions 


C] PROTECTION 
Wl SIGNIFICANCE 
C] SPECIFICATION: 





NOT A FLOATING-POINT REGISTER 
OP 1 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON FULL-WORD BOUNDARY 
OP 2 NOT ON DOUBLE-WORD 





(1 FIXED-POINT DIVIDE 

DD FIx€D-POINT OVERFLOW 
C1 FLOATING-POINT DIVIDE 
WM OPERATION 





MB iF RESULT = 0,SET TOO BOUNDARY 


OP 1 NOT EVEN NUMBERED REGISTER 
OP 1 NOT ODD NUMBERED REGISTER 
NONE 






Wir ReEsuct <o, set to1 
W@irf RESULT >o, SET TO2 
(OF OVERFLOW, SET TO 3 
(] UNCHANGED 











OOO OOOO 





The subtract unnormalized, long format (SWR) instruction causes the contents of the 
double word in the operand 2 (r.) register to be algebraically subtracted from the double 
word contents of the operand 1 (r,) register. The difference is placed in the double word 
operand 1 (r,) register. 


Explicit and Implicit Format: 





OPERAND 







A OPERATION A 


[symbol] 


SUB R4,R6 


Operational Considerations: 


a The execution of the SWR instruction is identical to that of the AWR instruction 
(11.9), except that the sign is reversed before addition. 
2 The condition code is set: 


to zero if result fraction is zero; 


to 1 if result fraction is less than zero; and 


to 2 if result fraction is greater than zero. 


Code 3 is not used. 
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Example: 
LABEL AOPERATIONA OPERAND 
l 10 16 
SUBLONG SWR R4,R6 


Before execution of the subtract unnormalized, long format (SWR) instruction, if we 
assume values of +1000 in R4 and +900 in R6, the contents of R4 and R6 will be: 


R4 before execution: 


R6 before and after execution: 


BPES ESRI Ce CRE RR 


R4 after execution: 


Ee or ee eee ee ee eee eS 
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12. Logical Instructions 


12.1. THE USE OF LOGICAL INSTRUCTIONS 


All operations performed by logical instructions are executed according to the rules of 
logic. Unlike decimal and fixed-point binary instructions, logical instructions disregard 
arithmetic signs. Most of these instructions manipulate data bit by bit and operate from 
left to right. 


This section contains the set of logical instructions that are standard. Section 14 contains 
the set of logical instructions that are featured. If your processor has the control feature, 
the featured instruction set is available for your use. 
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N 


12.2. AND (N) 


a a 
OPCODE FORMAT | INST. 
TYPE LGTH. 


Possible Program Exceptions 


By ADDRESSING Ml PROTECTION 

(0 DATA (INVALID SIGN/DIGIT) | [] SIGNIFICANCE 

(J DECIMAL DiviDE LC SPECIFICATION: 

CJ DECIMAL OVERFLOW NOT A FLOATING-POINT REGISTER 
CD execute OP 1 NOT ON HALF-WORD BOUNDARY 
(J EXPONENT OVERFLOW OP 2 NOT ON HALF-WORD BOUNDARY 
(J EXPONENT UNDERFLOW OP 2 NOT ON FULL-WORD BOUNDARY 
OC FIXED-POINT DIVIDE OP 2 NOT ON DOUBLE-WORD 


(0 FIXED-POINT OVERFLOW BOUNDARY 
CO] FLOATING-POINT DIVIDE OP 1 NOT EVEN NUMBERED REGISTER 


(J OPERATION OP 1 NOT ODD NUMBERED REGISTER 
NONE 


(BYTES) 





Condition Codes 


Ml iF RESULT = 0, SET TOO 
Wi i- RESULT #0, SET TO1 
CIF RESULT > 0, SET TO 2 
(tr OVERFLOW, SET TO 3 
[L) UNCHANGED 






O 
O 
O 
a 
O 
O 
O 
O 


The and (N) instruction performs a logical AND operation on the contents of the operand 1 
register and the contents of the full word in operand 2. The result is placed in the operand 
1 register. 


Explicit Format: 









LABEL A OPERATION A OPERAND 


[symbol] 


Implicit Format: 








LABEL AOPERATION A 


OPERAND 


When the N instruction is executed, a logical AND operation is performed on a bit in 
operand 1 and a bit in operand 2. The result of the AND operation replaces the bit just: 
accessed in operand 1. This instruction operates from left to right starting with the logical 
AND operations of bit O in both operands up to and including the logical AND operation of 
bit 31 in both operands. 
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The N instruction is used to turn off selected bits in the receiving field. The procedure is 
shown in the following truth table: 


When coding patterns used as operands in AND instructions, code a 0 in all bit positions 
in operand 2 that correspond to bit positions in operand 1 that you want to set to off (0), 
and a 1 in all bit positions in operand 2 that correspond to bit positions in operand 1 that 
you want to remain the same. 






After the N instruction is executed, the condition code is set to O if the result is all O’s; or 
the condition code is set to 1 if the result is all 1’s or a combination of 1’s and O's. 


Operational Considerations: 

= Any of the general registers (O through 15) can be used as operand 1. 

=  Operand 2 must be defined as either a full word or aligned on a full-word boundary. 
ws The logical AND operation executes upon all 32 bit positions of operands 1 and 2. 
s A O ina bit position in operand 2 sets its corresponding bit position in operand 1 to O. 


= A 1 ina bit position in operand 2 allows its corresponding bit position in operand 1 to 
remain the same. 


= §=6©The condition code is set accordingly. 





Example: 
LABEL AOPERATIONA OPERAND 
1 10 16 
L 8 ,HEXVALUE 
N 8, ANDPATRN 
DS OF —_ 
ANDPATRN DC X' POBOSOFF! 


HEXVALUE DC X'G6FGSG7D' 


UP-8061 Rev. 3 SPERRY UNIVAC 0S/3 12—4 
ASSEMBLER 


Register 8 before execution of N instruction: 


a iv 
retellelete bbe 









Register 8 after execution of N instruction: 


eefonofifoapoofeonfornfivoy] 
binary 
ee a 





only bits actually changed 


In this example, the hexadecimal value in HEXVALUE is loaded into register 8. Then a 
logical AND operation is performed on the hexadecimal pattern in ANDPATRN (operand 2) 
and the contents of register 8. Ones in bit positions 24 through 31 of ANDPATRN allow 
the corresponding bit positions in register 8 to remain the same. Zeros in bit positions O 
through 23 of ANDPATRN set the corresponding bit positions in register 8 to O. Since the 
high order four bit positions of byte 2 in register 8 are all 1’s, they are set to O; and since 
the remaining bit positions are already O, they remain O. The condition code is set to 1 
because the result is a combination of 1’s and O's. 
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NC 


12.3. AND (NC) 


General 


OBJECT 
INST. 
LGTH. 
(BYTES) 


Possible Program Exceptions 


W@ ADDRESSING MM PROTECTION 

(C0 DATA (INVALID SIGN/DIGIT) | [] SIGNIFICANCE 

(] DECIMAL Div!DE (J SPECIFICATION: 

DECIMAL OVERFLOW NOT A FLOATING-POINT REGISTER 
EXECUTE OP 1 NOT ON HALF-WORD BOUNDARY 
EXPONENT OVERFLOW OP 2 NOT ON HALF-WORD BOUNDARY 
EXPONENT UNDERFLOW OP 2 NOT ON FULL-WORD BOUNDARY 
FIXED-POINT DIVIDE OP 2 NOT ON DOUBLE-WORD 
FIXED-POINT OVERFLOW BOUNDARY 

FLOATING-POINT DIVIDE OP 1 NOT EVEN NUMBERED REGISTER 
OPERATION OP 1 NOT ODD NUMBERED REGISTER 
NONE 






































OPCODE FORMAT 
TYPE 





MNEM. }HEX, 


Condition Codes 


Mir RESULT = 0,SET TOO 
@ ir RESULT #0, SET TO1 
Clie RESULT > 0, SET TO 2 
DF OVERFLOW, SET TO 3 
(J UNCHANGED 
























ONOOOOOOO 
EAE Bobo) 


The and (NC) instruction performs a logical AND operation on the contents of operand 1 
and the contents of operand 2 which are both located in main storage. The result is placed 
in operand 1. 


Explicit Format: 








LABEL AOPERATION A 





OPERAND 


[symbol] 





d, (I,b, ),d, (b,) 


Implicit Format: 






A OPERATION A OPERAND 


[symbol] 


When the NC instruction is executed, a logical AND operation is performed on a bit in 
operand 1 and a bit in operand 2. The result of the AND operation replaces the bit 
accessed in operand 1. This instruction operates from left to right. The length of operand 
1, whether implied or explicit, determines the length of operand 2. Therefore, when the 
NC instruction is executed, the lengths of operands 1 and 2 are the same. 
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shown in the following truth table: 






Result 
Operand 1 Operand 2 | (Operand 1) 





When coding patterns used as operands in AND instructions, code a O in all bit positions 
in operand 2 that correspond to bit positions in operand 1 that you want to set to off (0), 
and a 1 in all bit positions in operand 2 that correspond to bit positions in operand 1 that 
you want to remain the same. 


After the NC instruction is executed, the condition code is set to O if the result is all O’s; or 
the condition code is set to 1 if the result is all 1’s or a combination of 1’s and O’s. 


Operational Considerations: 








= Operands 1 and 2 must be main storage locations. 
= The length of operand 1, whether implied or explicit, determines the length of 
operand 2. 
# A O ina bit position in operand 2 sets its corresponding bit position in operand 1 to O. 
= A 1 ina bit position in operand 2 allows its corresponding bit position in operand 1 to 
remain the same. 
= §=6The condition code is set accordingly. 
= Operands 1 and 2 can have overlapping bytes. 
Example: 
LABEL AOPERATIONA OPERAND 
1 10 16 
NC LOCAT1!,LOCAT2 
LOCATI vc PL2'=217! 


LOCAT2 DC X'FFFC! 
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® LOCAT1 before execution of NC instruction: 


binary 
aielea) eae 


LOCAT2 before and after execution of NC instruction: 


ran finee] ita | 1100) gina 
hex 
Parana 


LOCAT1 after execution of NC instruction: 


binary 
hex 





In this example, LOCAT1 is defined as a negative packed decimal number and LOCAT2 is 
defined as a field containing a hexadecimal value. A logical AND operation is performed on 

& the contents of LOCAT1 and LOCAT2. The result is placed in LOCAT1. The 1’s in bit 
positions O through 13 of LOCAT2 allow the corresponding bit positions in LOCAT1 to 
remain the same. Zeros in bit positions 14 and 15 of LOCAT2 set the corresponding bit 
positions in LOCAT1 to O. Since the low order bit position of LOCAT1 is 1, it is set to O; 
and the bit position adjacent to the low order bit position remains 0, since it is already O. 
The condition code is set to 1 because the result is a combination of 1‘s and O's. Note the 
sign value is changed from negative to positive. 
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NI 


12.4. AND (NI) 


ae 
OPCODE FORMAT | INST. 
TYPE LGTH. 


Possible Program Exceptions 


Bi ADDRESSING Ml PROTECTION 

[J DATA (INVALID SIGN/DIGIT) | [1] SIGNIFICANCE 

(7 DECIMAL DIVIDE (C0 SPECIFICATION: 

C1] DECIMAL OVERFLOW NOT A FLOATING-POINT REGISTER 
O EXECUTE i OP 1 NOT ON HALF-WORD BOUNDARY 


(BYTES) 





CJ EXPONENT OVERFLOW OP 2 NOT ON HALF-WORD BOUNDARY 

(] EXPONENT UNDERFLOW OP 2 NOT ON FULL-WORD BOUNDARY 

(CJ FIXED-POINT DIVIDE OP 2 NOT ON DOUBLE-WORD 

OO FIxED-POINT OVERFLOW BOUNDARY 

1 FLOATING-POINT DIVIDE OP 1 NOT EVEN NUMBERED REGISTER 

C oPERATION OP 1 NOT ODD NUMBERED REGISTER 
NONE 


Condition Codes 


MB iF RESULT =0,SET TOO 
@ if RESULT #0, SET TO1 
OIF RESULT > 0, SET TO 2 
CUIF OVERFLOW, SET TO 3 
(J UNCHANGED 








The and (NI) instruction performs a logical AND operation on the contents of operand 1 
located in main storage and the one byte of immediate data in operand 2. The result is 
placed in operand 1. 


Explicit Format: 






AOPERATIONA OPERAND 


[symbol] 


Implicit Format: 






A OPERATION A OPERAND 


[symbol] 


When the NI instruction is executed, a logical AND operation is performed on a bit in 
operand 1 and a bit in operand 2. The result of the AND operation replaces the bit just 
accessed in operand 1. This instruction operates from left to right. The length of operand 1 
can vary but the length of operand 2 is always one byte. Although operands 1 and 2 may 
have differing lengths, only one byte in operand 1 is used in conjunction with the one byte 
of immediate data in operand 2. The result replaces the one byte in operand 1 that was 
just accessed. If you do not specify the exact byte in operand 1 you want used in the 
execution with the one byte of data in operand 2, the first byte of operand 1 is used. 
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& The NI instruction is used to turn off selected bits in the receiving field. The procedure is 
shown in the following truth table: 





Result 
Operand 1 Operand 2 | (Operand 1) 





When coding patterns used as operands in AND instructions, code a O in all bit positions 
in operand 2 that correspond to bit positions in operand 1 that you want to set to off (0), 
and a 1 in all bit positions in operand 2 that correspond to bit positions in operand 1 that 
you want to remain the same. 


After the NI instruction is executed, the condition code is set to O if the result is all O's, or 
the condition code is set to 1 if the result is all 1’s or a combination of 1’s and O’s. 


Operational Considerations: 


= Operand 1 must be a main storage location. 
e = Operand 2 must be a 1-byte, self-defining term. 
s The length of operand 1 can vary. 
# A O ina bit position in operand 2 sets its corresponding bit position in operand 1 to O. 
« A 1 ina bit position in operand 2 allows its corresponding bit position in operand 1 to 
remain the same. 
# The condition code is set accordingly. 
= You can specify the exact byte in operand 1 you want used in the execution with the 
one byte in operand 2 through relative addressing. 
Example: 
LABEL AOPERATIONA OPERAND 
| 10 16 
NI RESULT+1 ,B'1G661611' 


RESULT DC BL2'GGGG111161161188' 
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RESULT before execution of NI instruction: 


RESULT +1 


aetieiN 
0 


78 15 






Operand 2 immediate before and after execution of NI instruction: 





RESULT after execution of NI instruction: 


RESULT +1 
ee a 


0000 '1111|0000 11000 
8 15 


ie) 7 










binary 
hex 











In this example, the content of RESULT is a 2-byte binary string of O’s and 1’s and the 
operand 2 immediate is a 1-byte binary string of O’s and 1's. A logical AND operation is 
performed on the contents of the second byte of RESULT and the one byte in operand 2. 
The result replaces the second byte of RESULT. The 1’s in bit positions O, 4, 6, and 7 of 
the operand 2 immediate allow the corresponding bit positions in the second byte of 
RESULT to remain the same. Zeros in bit positions 1, 2, 3, and 5 of the operand 2 
immediate set the corresponding bit positions in the second byte of RESULT to O. As a 
result, the second byte of RESULT has been changed from a hexadecimal 6C to a 


hexadecimal 08. 
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NR 


12.5. AND (NR) 


Possible Program Exceptions 


(J ADDRESSING C] PROTECTION 

(J DATA (INVALID SIGN/D1GIT) | [] SIGNIFICANCE 

(1 DECIMAL DIVIDE (] SPECIFICATION: 

(J DECIMAL OVERFLOW NOT A FLOATING-POINT REGISTER 
O execute OP 1 NOT ON HALF-WORD BOUNDARY 
(CO EXPONENT OVERFLOW OP 2 NOT ON HALF-WORD BOUNDARY 
(EXPONENT UNDERFLOW OP 2 NOT ON FULL-WORD BOUNDARY 
CO FIXED-POINT DIVIDE OP 2 NOT ON DOUBLE-WORD 


CJ FixeD-POINT OVERFLOW BOUNDARY 
C] FLOATING-POINT DIVIDE OP 1 NOT EVEN NUMBERED REGISTER 


(0 OPERATION OP 1 NOT ODD NUMBERED REGISTER 












OBJECT 
OPCODE FORMAT | INST. 










TYPE LGTH. 
(BYTES) 


Condition Codes 


Wif RESULT =0,SET TOO 














Wie RESULT <o, SET TO? 
Clif RESULT >0, SET TO 2 
Clif OVERFLOW, SET TO 3 
(J UNCHANGED 


®@ooO O8oooo0 


Z 
ie] 
Zz 
m 





The and (NR) instruction performs a logical AND operation on the contents of the operand 
1 and operand 2 registers. The result is placed in the operand 1 register. 


Explicit and Implicit Format: 






A OPERATION A OPERAND 


[symbol] 


When the NR instruction is executed, a logical AND operation is performed on a bit in the 
operand 1 register and a bit in the operand 2 register. The result replaces the bit accessed 
in operand 1. This instruction operates from left to right starting with the logical AND 
operation of bit O in both registers up to and including the logical AND operation of bit 31 
in both registers. 


The NR instruction is used to turn off selected bits in the receiving field. The procedure is 
shown in the following truth table: 


Result 
Operand 1 Operand 2 | (Operand 1) 
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When coding patterns used as operands in AND instructions, code O’s in all bit positions 
in operand 2 that correspond to bit positions in operand 1 that you want to set to off (0), 
and a 1 in all bit positions in operand 2 that correspond to bit positions in operand 1 that 
you want to remain the same. 


After the NR instruction is executed, the condition code is set to O if the result is all O’s or 
the condition code is set to 1 if the result is all 1’s or a combination of 1’s and O’s. 


Operational Considerations: 
= ~§=©Any of the general registers (0 through 15) can be used as operands 1 and 2. 


= The logical AND operation executes upon all 32 bit positions of the operand 1 and 2 
registers. 


# A O ina bit position in operand 2 sets its corresponding bit position in operand 1 to 0. 


= A 1 ina bit position in operand 2 allows its corresponding bit position in operand 1 to 
remain the same. 


a The condition code is set accordingly. 


Example: 
LABEL AOPERATIONA OPERAND 
1 10 16 
LM 5,6, 1NFOIN 
NR 5,6 
DS OF 
INFOIN DC X'FFCCBBAA' 
DC X'CCBBEEDD' 


Register 5 before execution of NR instruction: 


111141111 1100 1100] 1011 ;1011 | 1010; 1010 
Perefetefefe[ata 


Register 6 before and after execution of NR instruction: 


etetetelete fete 
















binary 
hex 






binary 


cic hex 
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Register 5 after execution of NR instruction: 


1100 11100 | 1000 ; 1000 | 1010 | 1010 | 1000 11000 
petefete fatale fe 


in this example, the LM instruction loads the two consecutive hexadecimal values aligned 
on a full-word boundary in main storage into registers 5 and 6. Then, a logical AND 
operation is performed on all 32 bits of registers 5 and 6. The result replaces register 5. 
The 1’s in respective bit positions in register 6 allow the corresponding bit positions in 
register 5 to remain the same. The O’s in the remaining bit positions in register 6 set the 
corresponding bit positions in register 5 to O. In effect, the content of register 5 is 
completely changed. 










binary 
hex 
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CL 


12.6. COMPARE LOGICAL (CL) 


General Possible Program Exceptions 
OBJECT a 
ADDRESSING PROTECTION 
OPCODE FORMAT | INST. a 
TYPE LGTH. 


[J DATA (INVALID SIGN/DIGIT) (LD SIGNIFICANCE 
MNEM. (BYTES) 


| mivem. | (J DECIMAL DIVIDE C] SPECIFICATION: 
CJ DECIMAL OVERFLOW NOT A FLOATING-POINT REGISTER 
| oe js} rx | 4 | 
Condition Codes 


0 execute OP 1 NOT ON HALF-WORD BOUNDARY 
CJ EXPONENT OVERFLOW OP 2 NOT ON HALF-WORD BOUNDARY 
CF EXPONENT UNDERFLOW OP 2 NOT ON FULL-WORD BOUNDARY 
C] FIXED-POINT DIVIDE OP 2 NOT ON DOUBLE-WORD 

Bir t, = OPERAND 2, SET TOO 

Bir tr, <OPERAND 2, SET TO 1 

Bir r, > OPERAND 2,SET TO 2 

CJIF OVERFLOW, SET TO 3 












O FIXED-POINT OVERFLOW BOUNDARY 
C] FLOATING-POINT DIVIDE OP 1 NOT EVEN NUMBERED REGISTER 


(0 OPERATION OP 1 NOT ODD NUMBERED REGISTER 


O 
O 
O 
=| 
O 
QO 
O 
O 


NONE 





CI UNCHANGED 


The compare logical (CL) instruction logically compares the contents of the operand 1 
register to the full word in operand 2. The result of the comparison determines the setting 
of the condition code, bits 34 and 35 of the PSW. (See 8.1.) 


Explicit Format: 






A OPERATION A OPERAND 


[symbol] 


Implicit Format: 






A OPERATION A 


OPERAND 


[symbol] 





Both operands 1 and 2 are considered unsigned binary values with all codes valid. That is, 
the comparison takes place regardless of data format. This instruction operates from left to 
right starting with the logical comparison of bit O in both operands and ending as soon as 
an inequality is reached, or the logical comparison of bit 31 in both operands is reached. 


After execution of the CL instruction, the condition code is set: 
To O if operand 1 = operand 2 
To 1 if operand 1 < operand 2 


To 2 if operand 1 > operand 2 
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Usually, a conditional branch instruction tests the resulting condition code for an equal to, 
less than, or greater than condition. If the condition is met, a branch takes place 
accordingly. If not, the program continues processing as shown in the following coding 
instruction. 


Operational Considerations: 





= = §=©6Any of the general registers (0 through 15) can be used as operand 1. 
=  Operand 2 must either be defined as a full word or aligned on a full-word boundary. 
# Both operands 1 and 2 are considered unsigned binary values. 
s The condition code is set accordingly. 
# Condition code 3 is not used. 
= Operands 1 and 2 remain unchanged after execution of this instruction. 
Example: 
LABEL AOPERATIONA OPERAND 
1 10 16 
SR 44 
L 8,=F'75! 
CL 8, FULVAL 
BH LOOP] 
ST 8,LOW 
LOOP | AR 4 ,8 
FULVAL DC F'64! 
LOW DS F 


Register 5 before and after execution of CL instruction. 


0000 10000 | 0000 {0000 |0000 }0000 










binary 
hex 





0100 ;1011 
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FULVAL before and after execution of CL instruction: 


0000 10000 | 0000 10000 [0000 | 0000 ;0100 ;0000 


in this example, register 4 is cleared to O and the full-word value coded as a literal is 
loaded into register 8. Then the content of register 8 is logically compared to the full-word 
value in FULVAL. Since the content of register 8 is greater than the content of FULVAL, 
the condition code is set to 2 and the branch to the instruction labeled LOOP1 takes place. 
If the result of the comparison was other than a greater than condition, no branch takes 
place and the ST instruction following the branch instruction is executed. 










binary 
hex 
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CLC 


12.7. COMPARE LOGICAL CHARACTERS (CLC) 


General Possible Program Exceptions 
OBJECT ADDRESSING @ PROTECTION 
OPCODE FORMAT | INST. a 
TYPE LGTH. 


[fa] DATA (INVALID SIGN/DIGIT) O SIGNIFICANCE 


(J DECIMAL DivibEe (CO SPECIFICATION: 
Fecic [os| ss | 6 | [J DECIMAL OVERFLOW NOT A FLOATING-POINT REGISTER 
Condition Codes 


CO execute OP 1 NOT ON HALF-WORD BOUNDARY 
Wir opi =o0P2,seET TOO 





































(] EXPONENT OVERFLOW OP 2 NOT ON HALF-WORD BOUNDARY 
CO EXPONENT UNDERFLOW OP 2 NOT ON FULL-WORD BOUNDARY 
OC] FIXED-POINT DIVIDE OP 2 NOT ON DOUBLE-WORD 

OD FIxED-POINT OVERFLOW BOUNDARY 

C] FLOATING-POINT DIVIDE OP 1 NOT EVEN NUMBERED REGISTER 
[] OPERATION OP 1 NOT ODD NUMBERED REGISTER 

NONE 


Mir op1<op2,setTToO1 
Bir opi > op2, SET To 2 
OCJtF OVERFLOW, SET TO3 
DO UNCHANGED 


OOO OOO0OO 


The compare logical characters (CLC) instruction logically compares the contents of 
operand 1 located in main storage to the contents of operand 2 located in main storage. 
The result of the comparison determines the setting of the condition code, bits 34 and 35 
of the PSW. (See 8.1.) 


Explicit Format: 





LABEL A OPERATION A OPERAND 


[symbol] 





d, (I,b, ).d, (b,) 


Implicit Format: 






A OPERATION A OPERAND 





[symbol] s, (I),s, 


Both operands 1 and 2 are considered unsigned binary values with all codes valid. That is, 
the comparison takes place regardless of data format. This instruction operates from left to 
right starting with the logical comparison of bit O in both operands and ending as soon as 
an inequality is reached (or the end of the field is reached). The length of operand 1, 
whether implied or explicit, determines the length of operand 2. Therefore, when the CLC 
instruction is executed, the length of operands 1 and 2 are the same. 


After execution of the CLC instruction, the condition code is set: 
To O if operand 1 = operand 2 
To 1 if operand 1 < operand 2 


To 2 if operand 1 > operand 2 
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Usually, a conditional branch instruction tests the resulting condition code for an equal to, @ 
less than, or greater than condition. If the condition is met, a branch takes place 

accordingly. If not, the program continues processing as shown in the following coding 

instruction. 

Operational Considerations: 

= Operands 1 and 2 must be located in main storage. 


= Both operands 1 and 2 are considered unsigned binary values. 


= ~§=©The length of operand 1 whether implied or explicit determines the length of operand 
2. 


= The condition code is set accordingly. 
= Operands 1 and 2 remain unchanged after the execution of this instruction. 


t Condition code 3 is not used. 








Example: 
LABEL AOPERATIONA OPERAND 
] 10 16 
CLC MONTH! (8) ,MONTH2 
BE ADRTN 
MVC MONTH 1 (8) ,MONTH2 
ADRTN AP TOTAL, MTD 
MONTHT = DC CL8'NOVEMBER! 
MONTH2 DC CL8' DECEMBER' 
TOTAL DC PL3'2869' 
MTD DC P's2h! 


MONTH1 before and after execution of CLC instruction: 


N 


E M B 


E 
1100 10101 1110110100 |1100 ;0010 |1100;0101 
refs fofe let [ete 













binary 
hex 





oO Vv R 
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MONTH2 before and after execution of CLC instruction: 


E E M B 


D Cc E 
1100} 0100] 1100; 0101 | 1100/0011 | 1100 10101 | 1101 ;0100 | 1100 10010 | 110010101 
eiefets lets [eis fete ler [els 


In this example, the content of MONTH is logically compared to the content of MONTH2. 
Since the content of MONTH1 (its binary value) is greater than the contents of MONTH2, 
the condition code is set to 2. The following branch instruction tests for an equal to 
condition (condition code of 0). Because that condition does not exist, no branch is taken, 
the MVC instruction following the BE branch instruction is executed, and the program 


continues processing. 










binary 
hex 


R 











UP-8061 Rev. 3 SPERRY UNIVAC OS/3 12—20 
ASSEMBLER 





CLI 


12.8. COMPARE LOGICAL IMMEDIATE (CLI) 






Possible Program Exceptions 
OPCODE ee BB ADDRESSING Wl PROTECTION 
pesiaey oe (C0 DATA (INVALID SIGN/DIGIT)| [] SIGNIFICANCE 
| wnem. |[HEX.| (Bytes) || CQ) DECIMAL DIVIDE CO SPECIFICATION: 


OJ DECIMAL OVERFLOW NOT A FLOATING-POINT REGISTER 
O) Execute . OP 1 NOT ON HALF-WORD BOUNDARY 








Condition Codes 


GF OPERAND 1 = in, SET TOO 
MIF OPERAND 1 <i,, SET TO 1 
Bir OPERAND 1 >i, SET TO2 
OIF OVERFLOW, SET TO 3 

(CJ UNCHANGED 


C0 EXPONENT OVERFLOW OP 2 NOT ON HALF-WORD BOUNDARY 
(0 EXPONENT UNDERFLOW OP 2 NOT ON FULL-WORD BOUNDARY 
0D FIXED-POINT DIVIDE OP 2 NOT ON DOUBLE-WORD 


OO FIxeED-POINT OVERFLOW BOUNDARY 
0 FLOATING-POINT DIVIDE OP 1 NOT EVEN NUMBERED REGISTER 


(J OPERATION OP 1 NOT ODD NUMBERED REGISTER 
NONE 







The compare logical immediate (CLI) instruction logically compares the content of operand 
1 located in main storage to the 1-byte immediate data of operand 2. The result of the 
comparison determines the setting of the condition code, bits 34 and 35 of the PSW. (See 
8.1.) 


Explicit Format: 








LABEL A OPERATION A OPERAND 












[symbol] 


Implicit Format: 








A OPERATION A OPERAND 






[symbol] 





Both operands 1 and 2 are considered unsigned binary values with all codes valid. That 
is, the comparison takes place regardless of data format. The length of operand 1 can vary 
in length but the length of operand 2 is always one byte. Although the lengths of operands 
1 and 2 differ, only one byte of operand 1 is compared to the one byte of immediate data 
in operand 2. If you don’t specify the exact byte in operand 1 you want logically compared 
to the one byte of data in operand 2, the first byte of operand 1 is used. This instruction 

operates from left to right starting with the logical comparison of bit O of the byte specified 
in operand 1 and bit O of operand 2, and ending as soon as an inequality is found, or the 
logical comparison of bit 7 of the byte specified in operand 1 and operand 2 is reached. 
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After the execution of the CLI instruction, the condition code is set: 

To O if operand 1 = operand 2 

To 1 if operand 1 < operand 2 

To 2 if operand 1 > operand 2 
Usually, a conditional branch instruction tests the condition code for an equal to, less 
than, or greater than condition. If that condition is met, the branch takes place. If not, no 
branch takes place and the program continues processing as shown in the following 
coding instruction. 
Operational Considerations: 
= Operand 1 must be located in main storage. 


= Operand 2 must be a 1-byte, self-defining term. 


= You can specify the exact byte in operand 1 you want logically compared to the one 
byte in operand 2 through relative addressing. 


= Operands 1 and 2 remain unchanged after the execution of this instruction. 
= ~=©The condition code is set accordingly. 
= ~The length of operand 1 can vary. 


a Condition code 3 is not used. 


Example: 

LABEL AOPERATIONA OPERAND 

1 10 «+16 

a Ee a 
CLI STORAGE+1 ,X'F7' 
BE EQUALITY 
PACK STORAGEP (2) , STORAGE (3) 

EQUALITY MVC BUF (1) ,STORAGE+1 

BUF DC CL2'G' 

STORAGE DC X'F6F7F2' 


STORAGEP DC PL2'@' 
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STORAGE before and after execution of CLI instruction: 


STORAGE + 1 


a ee” 


Byte to be compared 
with operand 2 


Operand 2 immediate before and after execution of CLI instruction: 


a 


hex 
FoI 7 


In this example, the second byte in STORAGE is compared to the 1-byte immediate data in 
operand 2. Since the content of the second byte of STORAGE is equal to operand 2, the 
condition code is set to O, and the branch to the instruction labeled EQUALITY takes place. 
If the result of the comparison is not equal, no branch takes place, the PACK instruction 
following the branch instruction is executed, and the program continues processing. 





Example: 
LABEL AOPERATIONA OPERAND 
1 10 16 
LA 8,526 
CLI AREA,C'T! 
BE TOOLRTN 
MVI HOLD,C'T' 
TOOLRTN S 8,=F']! 
AREA DC CL3'T12' 


HOLD DC cL.i' ! 
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AREA before and after execution of CLI instruction: 





Byte to be compared 
with operand 2 


Operand 2 immediate before and after execution of CLI instruction: 


In this example, register 8 is loaded with a value of 526. Then the contents of the first 
byte of AREA is logically compared to operand 2. Because no one byte is specified in 
AREA, the first byte is used. Since the content of byte 1 of AREA is equal to the content of 
operand 2, the condition code is set to O, and the branch to the instruction labeled 
TOOLRTN takes place. If the result of the comparison is not equal, no branch takes place, 
the MVI instruction following the branch instruction is executed, and the program 
continues processing. 


Example: 
LABEL AOPERATIONA OPERAND 
1 10 16 
Ss Sa BN A 
LM 3,4,LOADREG 
CLI NUMIN,X'CI! 
BE STOCKNO 
MVI NEWHOLD,NUMIN 
STOCKNO AR 3,4 
NEWHOLD O1C cLI' ! 
NUMIN DC CL4'A256! 
LOADREG DC F'S264! 
DC FY)! 
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NUMIN before and after execution of the CLI instruction: 


ete [eie [ete le fe 


Operand 2 immediate before and after execution of the CLI instruction: 











binary 
hex 





1100 | 0001 binary 


hex 


Q 
_ 


In this example, two consecutive full words in main storage are loaded into registers 3 
and 4. The first byte of NUMIN is logically compared to the 1-byte immediate in operand 2. 
Because no one byte is specified in NUMIN, the first byte is moved. Since the content of 
byte 1 of NUMIN is equal to the content of operand 2, the condition code is set to 0, and 
the branch to the instruction labeled STOCKNO takes place. If the result of the comparison 
is not equal, no branch takes place, the MVI instruction following the branch instruction is 
executed, and the program continues processing. 
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CLR 


12.9. COMPARE LOGICAL (CLR) 


Possible Program Exceptions 


(J ADDRESSING CD PROTECTION 

(1 DATA (INVALID SIGN/DIG!T) | [] SIGNIFICANCE 

(1 DECIMAL DIvIDE CO SPECIFICATION: 

CJ DECIMAL OVERFLOW NOT A FLOATING-POINT REGISTER 
0 Execute OP 1 NOT ON HALF-WORD BOUNDARY 
(1 EXPONENT OVERFLOW OP 2 NOT ON HALF-WORD BOUNDARY 
(1 EXPONENT UNDERFLOW OP 2 NOT ON FULL-WORD BOUNDARY 
C FIXED-POINT DIVIDE OP 2 NOT ON DOUBLE-WORD 


OO FIXED-POINT OVERFLOW BOUNDARY 
CL FLOATING-FOINT DIVIDE OP 1 NOT EVEN NUMBERED REGISTER 


(1 OPERATION OP 1 NOT ODD NUMBERED REGISTER 























OBJECT 
INST. 


OPCODE | FORMAT 
TYPE LGTH. 


join | ts] ork | 2 | 
Condition Codes 


Wirr,=r,,seEtTtToo 

@irr,<¢.,setrto1 
1>‘2 

Birr, >r,, SET TO 2 

(J1F OVERFLOW, SET TO 3 














MOO OOO000 


2 
ie} 
Zz 
m 





DL UNCHANGED 


The compare logical (CLR) instruction logically compares the content of the operand 1 
register to the content of the operand 2 register. The result of the comparison determines 
the setting of the condition code, bits 34 and 35 of the PSW. (See 8.1.) 


Explicit and Implicit Format: 






A OPERATION A OPERAND 


Both operands 1 and 2 are considered unsigned binary values with all codes valid. That 
is, the comparison takes place regardless of data format. This instruction operates from 
left to right starting with the logical comparison of bit O in both operands and ending as 
soon as an inequality is found, or the logical comparison of bit 31 in both operands is 
reached. 


After execution of the CLR instruction, the condition code is set: 

To O if operand 1 = operand 2 

To 1 if operand 1 < operand 2 

To 2 if operand 1 > operand 2 
Usually, a conditional branch instruction tests the resulting condition code for an equal to, 
less than, or greater than condition. If the condition is met, a branch takes place 


accordingly. If not, the program continues processing as shown in the following coding 
instruction. 


UP-8061 Rev. 3 


Operational Considerations: 
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= ~=Any of the general registers (0 through 15) can be used as operands 1 and 2. 
= Both operands 1 and 2 are considered unsigned binary values. 
= The condition code is set accordingly. 
= Operands 1 and 2 remain unchanged after the execution of this instruction. 
= Condition code 3 is not used. 
Example: 
LABEL AOPERATIONA OPERAND 
1 10 16 
SR 7,7 
L 5,=F'1250! 
A 7,=F'875' 
COMPARE CR 5,7 
BH ADD2 
CVD 7,DBLWD 
B END 
ADD2 AH 7,=H'375' 
B COMPARE 
END MVC BUF , DBLWD+5 
DBLWD DS D 
BUF nC PL3'@' 


In this example, register 7 is cleared to O. A full word containing the decimal value 1250 
is loaded into register 5. Another full word containing the decimal value 875 is added to 
register 7. Then the content of register 5 is logically compared to the content of register 7. 
Since the content of register 5 is greater than the content of register 7, the condition code 
is set to 2, and the branch to the instruction labeled ADD2 takes place. There, a half word 
containing the decimal value 375 is added to register 7. An unconditonal branch to the 
instruction labeled COMPARE takes place and registers 5 and 7 are logically compared 
again. This time, the content of register 5 is equal to the content of register 7. Since an 
equal to condition exists, the condition code is set to O, and no branch takes place. The 
CVD instruction following the branch instruction is executed and the program continues 
processing. 
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12.10. EXCLUSIVE OR (X) 


OPCODE OBJECT |! my ADDRESSING PROTECTION 
ee been (J DATA (INVALID SIGN/DIGIT) | [J SIGNIFICANCE 
MNEM. (BYTES) |] LJ] DECIMAL DIVIDE C] sPecirFICATION: 


L MneM OJ DECIMAL OVERFLOW NOT A FLOATING-POINT REGISTER 
| x [a{ px | 4 | CO Execute OP 1 NOT ON HALF-WORD BOUNDARY 
(] EXPONENT OVERFLOW 


OP 2 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON FULL-WORD BOUNDARY 
Oo accU haa Sento CL FIXED-POINT DIVIDE OP 2 NOT ON DOUBLE-WORD 
Bir RESULT £0, SET TO 1 OD FIXED-POINT OVERFLOW 
Clie RESULT >0O, SET TO2 (] FLOATING-POINT DIVIDE 


BOUNDARY 

OP 1 NOT EVEN NUMBERED REGISTER 
DJF OVERFLOW, SET TO3 (J OPERATION 
(] UNCHANGED 


OP 1 NOT ODD NUMBERED REGISTER 
NONE 





O 
| 
O 
a 
0 
O 
O 
O 


The exclusive or (X) instruction performs an exclusive OR operation on the content of the 
operand 1 register and the full word in operand 2. The result is placed in operand 1 and 
also determines the setting of the condition code, bits 34 and 35 of the PSW. (See 8.1.) 


Explicit Format: 






A OPERATION A OPERAND 


[symbol] 


Implicit Format: 








A OPERATION A 


OPERAND 





LABEL 


When the X instruction is executed, an exclusive OR operation is performed on a bit in 
operand 1 and a bit in operand 2. The result of the exclusive OR operation replaces the bit 
just accessed in operand 1. This instruction operates from left to right starting with the 
exclusive OR operation of bit O in both operands up to and including the exclusive OR 
operation of bit 31 in both operands. 
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The X instruction is used to modify bits in the receiving field. The procedure is shown in 
the following truth table: 


Result 





When coding patterns used as operands in exclusive OR instructions, the following codes 
are set: . 


® OQ in all bit positions in operand 2 that correspond to bit positions in operand 1 that 
you want to remain the same. 


| 1 in all bit positions in operand 2 that correspond to bit positions containing O’s in 
operand 1 that you want set to 1. 


= $1 in all bit positions in operand 2 that correspond to bit positions containing 1’s in 
operand 1 that you want set to O. 


After the X instruction is executed, the condition code is set as follows: 
To O if result is all O's. 
To 1 if result is a combination of 1’s and O's. 
Operational Considerations: 
= Any of the general registers (O through 15) can be used as operand 1. 
= Operand 2 must be either defined as a full word or aligned on a full-word boundary. 
u The condition code is set accordingly. 


a Condition code 2 and 3 are not used. 
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Example: 

LABEL AOPERATIONA OPERAND 
! 10 16 

L 6, VAL 

X 6, XPATTERN 

DS OF 
VAL DC X' PBBOCAF2! 
XPATTERN DC X' GPPBSCSBD! 


Register 6 before execution of X instruction: 


0000 ; 0000 | 0000 | 0000 | 1100 ,1010 111110010] 
ee see 






binary 
hex 





XPATTERN before and after execution of X instruction: 


Fi2 
000010000 [0000 | 0000} 1100 10101} 0000: 1101 



















binary 
Register 6 after execution of X instruction: 
binary 


0000 | 0000 | 0000 | 0000 | 0000; 1111) 111141111 
Posie sk Ocoee Fee ee) 


hex 





In this example, the content of VAL is loaded into register 6. Then the exclusive OR 
operation is performed on the contents of register 6 and the contents of XPATTERN. The 
resultant modified binary string is placed in register 6. Since the result is a combination of 
O's and 1's, the condition code is set to 1. 
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XC 


12.11. EXCLUSIVE OR (XC) 


OPCODE OBJECT || gl ADDRESSING Mi PROTECTION 
pesca ipa (C DATA (INVALID SIGN/DIGIT)| [] SIGNIFICANCE 


TYPE LGTH. 
MNEM (BYTES) || (J) DECIMAL DiviDE CD SPECIFICATION: 
C0 DECIMAL OVERFLOW NOT A FLOATING-POINT REGISTER 


| xc jo7| ss | 6 | OJ execute OP 1 NOT ON HALF-WORD BOUNDARY 
DD EXPONENT OVERFLOW OP 2 NOT ON HALF-WORD BOUNDARY 
Condition Codes 


(J EXPONENT UNDERFLOW OP 2 NOT ON FULL-WORD BOUNDARY 
MB iF RESULT =0,SETTOO 
































LF FIXED-POINT DIVIDE OP 2 NOT ON DOUBLE-WORD 


O FIXED-POINT OVERFLOW BOUNDARY 
C] FLOATING-POINT DIVIDE OP 1 NOT EVEN NUMBERED REGISTER 


(1 OPERATION OP 1 NOT ODD NUMBERED REGISTER 
NONE 


Wie RESULT #0, SET TO1 
Cte RESULT > 0, SET TO 2 
LJIF OVERFLOW, SET TO3 
[J UNCHANGED 


OOO OOoOoO0 





The exc/usive or (XC) instruction performs an exclusive OR operation on the contents of 
operand 1 and operand 2, both located in main storage. The result is placed in operand 1 
and also determines the setting of the condition code, bits 34 and 35 of the PSW. (See 
8.1.) 


Explicit Format: 





A OPERATION A 





LABEL OPERAND 


[symbol] 





d, (Ib, ),d, (b,) 


Implicit Format: 








A OPERATION A 





LABEL 





OPERAND 


[symbol] 


When the XC instruction is executed, an exclusive OR operation is performed on a bit in 
operand 1 and a bit in operand 2. The result of the exclusive OR operation replaces the bit 
accessed in operand 1. This instruction operates from left to right. The length of operand 
1, whether implied or explicit, determines the length of operand 2. Therefore, when the XC 
instruction is executed, the lengths of operands 1 and 2 are the same. 
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The XC instruction is used to modify bits in the receiving field. The procedure is shown in 
the following truth table: 


Result 





When coding patterns used as operands in exclusive OR instructions, the following codes 
are set: 


= O in all bit positions in operand 2 that correspond to bit positions in operand 1 that 
you want to remain the same. 


7 1 in all bit positions in operand 2 that correspond to bit positions containing O’s in 
operand 1 that you want set to 1. 


2 1 in all bit positions in operand 2 that correspond to bit positions containing 1’s in 
operand 1 that you want set to O. 


After the XC instruction is executed, the condition code is set as follows: 
To O if result is all O's. 
To 1 if result is a combination of 1’s and O's. 

Operational Considerations: 

= Operands 1 and 2 must be located in main storage. 

m The condition code is set accordingly. 


s Operands 1 and 2 can have overlapping bytes. 


Example: 
LABEL AOPERATIONA OPERAND 
l 10 16 
XC A,B 
XC B,A 
A DC BLI'GOG11811' 


B DC BL1'S6916891' 
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A before execution of first XC instruction: 


000111011 ; 
binary 


hex 


B before and after execution of first XC instruction: 


1|0001 bicany 


hex 


Flt 


A after execution of first XC instruction: 


{1010 


: 


binary 
hex 


B before execution of second XC instruction: 


000110001 binary 


hex 


A before and after execution of second XC instruction: 


00001 1010 binary 


hex 


B after execution of second XC instruction: 


000111011 ' 
binary 


hex 


In this example, the exclusive OR operation is performed on the contents of A and B. The 
resultant modified binary string of 1’s and O’s is placed in A. Then another exclusive OR 
operation is performed on the contents of B and A (now modified). That resultant modified 
binary string of 1’s and O’s is placed in B. Note that the sequence of executions of the 
exclusive OR operation on A and B, then B and A results in A containing the resultant 
modified binary string and B containing the original contents of A. Note that the original 
contents of A is saved without use of another area in main storage. 














UP-8061 Rev. 3 SPERRY UNIVAC OS/3 12—33 
ASSEMBLER 


Xl 


12.12. EXCLUSIVE OR (Xl) 


Possible Program Exceptions 


OBJECT 
ADDRESSING W@ PROTECTION 
OPCODE | FORMAT | INST. a 
See peri (J DATA (INVALID SIGN/OIGIT) | (] SIGNIFICANCE 


MNEM. (BYTES) || () DECIMAL DiviDE CO) SPECIFICATION: 


[| MNEM. 
0 DECIMAL OVERFLOW NOT A FLOATING-POINT REGISTER 
| xi fo7] sf 4 | O EXECUTE . OP 1 NOT ON HALF-WORD BOUNDARY 
O EXPONENT OVERFLOW 


OP 2 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON FULL-WORD BOUNDARY 

Micecsuneo series 0 FIXED-POINT DIVIDE OP 2 NOT ON DOUBLE-WORD 

@ ir RESULT #0, SETTO1 OC FIXED-POINT OVERFLOW 

Clif RESULT >0, SET TO2 (CO FLOATING-POINT DIVIDE 


BOUNDARY 

OP 1 NOT EVEN NUMBERED REGISTER 
CIF OVERFLOW, SET TO 3 (0 OPERATION 
(J UNCHANGED 


OP 1 NOT ODD NUMBERED REGISTER 
NONE 


o 
O 
O 
O 
O 
O 
D 
O 





The exclusive or (X\) instruction performs an exclusive OR operation on the contents of 
one byte of operand 1 located in main storage and the one byte of immediate data in 
operand 2. The result is placed in operand 1 and also determines the setting of the 
condition code, bits 34 and 35 of the PSW. (See 8.1.) 


Explicit Format: 









A OPERATION A OPERAND 





LABEL 


[symbol] 


Implicit Format: 






A OPERATION A 


OPERAND 


[symbol] 


When the XI instruction is executed, an exclusive OR operation is performed on a bit in 
operand 1 and a bit in operand 2. The result of the exclusive OR operation replaces the bit 
accessed in operand 1. This instruction operates from left to right. The length of operand 1 
can vary but the length of operand 2 is always one byte. Although operands 1 and 2 may 
have differing lengths, only one byte in operand 1 is used in the exclusive OR operation. 
The result replaces the one byte in operand 1 that was accessed. If you do not specify the 
exact byte in operand 1 you want used in the exclusive OR operation, the first byte of 
operand 1 is used. 
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The XI instruction is used to modify bits in the receiving field. The procedure is shown in eS) 
the following truth table: 


a 


When coding patterns are used as operands in exclusive OR instructions, the following 
codes are set: 









a 0 in all bit positions in operand 2 that correspond to bit positions in operand 1 that 
you want to remain the same. 


/ 1 in all bit positions in operand 2 that correspond to bit positions containing O's in 
operand 1 that you want set to 1. 


= 1 in all bit positions in operand 2 that correspond to bit positions containing 1's in 
operand 1 that you want set to O. 





After the XI instruction is executed, the condition code is set as follows: 
To O if result is all O's. 
To 1 if result is a combination of 1’s and O's. 

Operational Considerations: 

= Operand 1 must be a main storage location. 

= = Operand 2 must be a 1-byte self-defining term. 

= The length of operand 1 can vary. 

= The condition code is set accordingly. 


= You can specify the exact byte in operand 1 you want used with the one byte in 
operand 2 through relative addressing. 





@ 
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Example: 

LABEL AOPERATIONA OPERAND 
1 10 16 

CLC I TEMNO(1) ,STNDNO 

BE SWTCHON 
SWTCHON XI ITEMNO+1,'91! 

MVC PROCESS, 1 TEMNO 
ITEMNO DC X' F269" 
STNDNO dnc X'F2! 
PROCESS DS CL2 


ITEMNO before execution of XI instruction: 


hex 


0000 ;0000 Binary 


Operand 2 immediate before and after execution of XI instruction: 


0000/ 0001 binary 


hex 


ITEMNO after execution of XI instruction: 








000010001 


In this example, the first byte of ITEMNO is logically compared to the content of STNDNO. 
Since they compare equally, the condition code is set to QO and the branch to the 
instruction labeled SWTCHON takes place. There, the exclusive OR operation is performed 
on the first byte of ITEMNO and the one byte of data in operand 2. The result replaces the 
first byte in ITEMNO. The only change to the content of ITEMNO is the setting of the low 
order bit. This is an example of how the XI instruction can be used in setting programmed 
binary bit switches that are useful in testing for existing conditions within the logic of the 
program. 


binary 
hex 
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XR 


12.13. EXCLUSIVE OR (XR) 


Possible Program Exceptions 


(J ADDRESSING [1] PROTECTION 













OBJECT 


OPCODE 
= feat tic oe CO DATA (INVALID SIGN/DIGIT) | [J SIGNIFICANCE 
pee fre - (Bytes) || D DECIMAL DiviDE DC SPECIFICATION: 


CJ DECIMAL OVERFLOW 

OO execute 

CO EXPONENT OVERFLOW 
0 EXPONENT UNDERFLOW 
CO FIXED-POINT DIVIDE 

OO FIXED-POINT OVERFLOW 
CO FLOATING-POINT DIVIDE 
[CL] OPERATION 


NOT A FLOATING-POINT REGISTER 

OP 1 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON FULL-WORD BOUNDARY 


OP 2 NOT ON DOUBLE-WORD 
BOUNDARY 


OP 1 NOT EVEN NUMBERED REGISTER 
OP 1 NOT ODD NUMBERED REGISTER 


Condition Codes 


@ if RESULT = 0, SET TOO 
@ iF RESULT 40, SET TO1 
DJ1iF RESULT > 0, SET TO 2 
(JF OVERFLOW, SET TO 3 
(J UNCHANGED 


O 
0 
O 
O) 
0 
O 
O 
a 


NONE 





The exclusive or (XR) instruction performs an exclusive OR operation on the contents of 
the operand 1 register and operand 2 register. The result is placed in the operand 1 
register and also determines the setting of the condition code, bits 34 and 35 of the PSW. 
(See 8.1.) 


Explicit and Implicit Format: 






A OPERATION A OPERAND 


When the XR instruction is executed, an exclusive OR operation is performed on a bit in 
the operands of 1 and 2 registers. The result of the exclusive OR operation replaces the bit 
just accessed in operand 1. This instruction operates from left to right starting with the 
execution of the exclusive OR operation on bit O in both registers up to and including bit 
31 in both registers. 


The XR instruction is used to modify bits in the receiving field. The procedure is shown in 
the following truth table: 


O 
1 







Result 
(Operand 1) 
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When coding patterns are used as operands in exclusive OR instructions, the following 
codes are set: 


a O in all bit positions in operand 2 that correspond to bit positions in operand 1 that 
you want to remain the same. 


# 1 in all bit positions in operand 2 that correspond to bit positions containing O’s in 
operand 1 that you want set to 1. 


2 1 in all bit positions in operand 2 that correspond to bit positions containing 1's in 
operand 1 that you want set to O. 


After the XR instruction is executed, the condition code is set as follows: 
To O if result is all O's. 
To 1 if result is a combination of 1’s and O's. 
Operational Considerations: 
= §6Any of the general registers (0 through 15) can be used as operands 1 and 2. 


= The condition code is set accordingly. 


Example: 
LABEL AOPERATIONA OPERAND 
1 10 16 
a a a 
SR 4,4 
L 7, CONTENTS 
A 7,2F'25! 
CVD 7, DBLWD 
MVC AREA, DBLWD+5 
XR 737 
CONTENTS DC F'56' 
DBLWD DS D 


AREA DS PL3 





Y 
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Register 7 before execution of XR instruction: 


0000 | 0000} 0000 | 0000 | 0000 ; 0000} 001110010 
Raa es aE ea 


Register 7 after execution of XR instruction: 


0000 |0000 } 0000 {| 0000 /0000 10000 }0000 |0000 


In this example, the full word in CONTENTS is loaded into register 7. A full word 
containing the decimal value of 25 is added to register 7, and that result is converted into 
its decimal equivalent and placed in DBLWD in main storage. Then the content of the last 
three bytes of DBLWD are moved into a smaller field, and the exclusive OR operation is 
performed on the contents of register 7 and itself. The result is a field of O’s. This is 
another method of clearing a field to O’s. 







binary 
hex 









binary 
hex 

















UP-8061 Rev. 3 SPERRY UNIVAC OS/3 12-39 
ASSEMBLER 


@ IC 


12.14. INSERT CHARACTER (IC) 


Possible Program Exceptions 


Hi AODRESSING PROTECTION 

1) DATA (INVALID SIGN/DIGIT) C0 SIGNIFICANCE 

(CJ DECIMAL DIVIDE CJ SPECIFICATION: 

OC DECIMAL OVERFLOW NOT A FLOATING-POINT REGISTER 
0 Execute OP 1 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON FULL-WORD BOUNDARY 
OP 2 NOT ON DOUBLE-WORD 
BOUNDARY 

OP 1 NOT EVEN NUMBERED REGISTER 
OP 1 NOT ODD NUMBERED REGISTER 


OBJECT 
OPCODE FORMAT | INST. 


TYPE LGTH. 
MNEM. |HEX. (BYTES) 


Condition Codes 


CJ tF RESULT = 0,SET TOO 
Cif RESULT <0, SET TO1 
DF RESULT > 0, SET TO 2 
CIF OVERFLOW, SET TO 3 
BB UNCHANGED 





0 EXPONENT OVERFLOW 
(CD EXPONENT UNDERFLOW 
O FIXED-POINT DIVIDE 

CO FIXED-POINT OVERFLOW 
C0 FLOATING-POINT DIVIDE 
(C0 OPERATION 








OOO OOnOO 


2 
fe} 
z 
m 


The insert character (IC) instruction places one byte of data from operand 2 into the 
rightmost byte of the operand 1 register. 


Explicit Format: 






A OPERATION A OPERAND 


[symbol] 


Implicit Format: 






A OPERATION A 


OPERAND 


[symbol] 


The data in operand 2 can be defined in any format. The length of operand 2 can vary but 
the length of operand 1 is always four bytes. Although operands 1 and 2 can have 
differing or equal lengths, only one byte of operand 2 is inserted into the rightmost byte of 
the operand 1 register. The remaining three bytes of operand 1 remain the same. If you do 
not specify the exact byte in operand 2 you want inserted into operand 1, the first byte of 
operand 2 is used. 


Operational Considerations: 
= §6Any of the general registers (0 through 15) can be used as operand 1. 


& = §=The length of operand 2 can vary. 
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= You can specify the exact byte in operand 2 you want inserted into the rightmost byte 
of operand 1 through relative addressing. 


= The condition code remains unchanged. 





Example: 
LABEL AOPERATIONA OPERAND 
1 10 16 
L 4 HEXVAL 
CLC HEXVAL+3(1) ,NEWVAL 
BNE INSERT 
INSERT IC k SNEWVAL 
DS OF 
HEXVAL DC X'99G664A2 ' 
NEWVAL DC X' FA! 


Register 4 before execution of IC instruction: 


HEXVAL+3 


0000 | 0000} 0000 ! 0000 | 01100100 |1010 ,0010 


NEWVAL before and after execution of IC instruction: 


Cn rc 


hex 










binary 
hex 





Register 4 after execution of instruction: 


0000 | 0000 | 0000 ; 0000 |0110 ;0100 1111 jo100 


In this example, the content of HEXVAL is loaded into register 4. Then the fourth byte of 
HEXVAL is logically compared to the one byte in NEWVAL. Since the content of 
HEXVAL-+3 is greater than NEWVAL, the condition code is set to 2 and the branch to the 
instruction labeled INSERT takes place because a not equal to condition exists. There, the 
1-byte field in NEWVAL is inserted into the rightmost byte of register 4. 










binary 
hex 
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LA 


12.15. LOAD ADDRESS (LA) 


Possible Program Exceptions 








OBJECT 
INST. 


OPCODE | FORMAT 
TYPE LGTH. 


HEX. (BYTES) 
Condition Codes 


CliF RESULT = 0, SET TOO 


(J ADDRESSING ( PROTECTION 

(0 DATA (INVALID SIGN/DIGIT) | [] SIGNIFICANCE 

CJ DECIMAL DiviDE (C0 SPECIFICATION: 

(DECIMAL OVERFLOW NOT A FLOATING-POINT REGISTER 
O] execute OP 1 NOT ON HALF-WORD BOUNDARY 









(C0 EXPONENT OVERFLOW OP 2 NOT ON HALF-WORD BOUNDARY 

(C] EXPONENT UNDERFLOW OP 2 NOT ON FULL-WORD BOUNDARY 

C0 FIXED-POINT DIVIDE OP 2 NOT ON DOUBLE-WORD 

(0 FIxED-POINT OVERFLOW BOUNDARY 

CO FLOATING-POINT DIVIDE OP 1 NOT EVEN NUMBERED REGISTER 

(0 opeRATION OP 1 NOT ODD NUMBERED REGISTER 
NONE 


OlirF RESULT <0, SET TO1 
Clif RESULT >0, SET TO2 
CJIF OVERFLOW, SET TO 3 
BB UNCHANGED 





The /oad address (LA) instruction places the address of the main storage location of 
operand 2 into bit positions 8 through 31 (rightmost 3 bytes) of the operand 1 register. Bits 
O through 7 (leftmost byte) of the operand 1 register are set to O's. 


Explicit Format: 






A OPERATION A OPERAND 


[symbol] r, d, (x, ,b,) 


Implicit Format: 





A OPERATION A OPERAND 


Operand 2 can be any byte in main storage and does not have to be aligned on a full-word 
boundary. Operand 2 can also be a self-defining term. The three rightmost bytes of 
operand 1 are filled and the leftmost byte of operand 1 is set to O's. 

Operational Considerations: 


= Any of the general registers (O through 15) can be used as operand 1. 


= Any of the general registers (1 through 15) can be used as operand 2. These registers 
are used as self-defining terms. 


= Operand 2 can be any label in main storage. 
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Example: 
LABEL AOPERATIONA OPERAND 
1 10 16 
SR 44 
LA 6 ,CARDIN+38 
ZAP WKLYHRS ,=P 'g! 
ADDLOOP PACK 6(3,6) ,6(3,6) 
AP WKLYHRS ,8 (3,6) 
A 4 CON] 
A 6,CON3 
C 4 CON7 
BL ADDLOOP 
CARDIN DS CL8¢ 
WKLYHRS DS PL3 
CON] bc Fiy! 
CON3 oc F'3! 
CON7 Dc F'7! 


In this example, register 4 is cleared to 0. Then the LA instruction loads the address of 
CARDIN+38 into register 6. The ZAP instruction sets the field labeled WKLYHRS to a 
packed field of O’s. Since the address of the byte located at card column 39 is in register 
6, the PACK instruction packs the 3-byte field (defined in explicit format) into itself. Note 
that there is a displacement value of O. Therefore, the base address is not modified 
through displacement values. The 3-byte packed field is now added to WKLYHRS which 
will eventually contain the total number of hours an employee works in one week. A full 
word containing the decimal value of one is added to register 4 each time a 3-byte field is 
packed and added to WKLYHRS. Register 4 acts as a counter to keep track of the number 
of times the ADDLOOP routine has been executed. A full word containing the decimal 
value of three is added to register 6 modifying the address by increasing it three bytes 
each time the A instruction is executed. This allows the successive fields on the input card 
to be processed. Then the content of register 4 is compared to the decimal value of 7 in 
CON7. The branch if low (BL) instruction tests the condition code for a less than condition. 
Since the content of register 4 is less than the content of CON7, a branch to the 
instruction labeled ADDLOOP takes place. The ADDLOOP routine is executed seven times. 
After the seventh execution, the content of register 4 is not less than CON7 and the 
instruction following the BL instruction is executed. 
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MVI 


12.16. MOVE IMMEDIATE (MVI) 


Possible Program Exceptions 


IB ADDRESSING W PROTECTION 




























ee eed 












OPCODE | FORMAT 
TYPE 





penn (1 DATA (INVALID SIGN/DIGIT)} [] SIGNIFICANCE 
(BYTES) || [) DECIMAL DIVIDE CO sPECIFICATION: 










CD DECIMAL OVERFLOW 

OC execute 

CJ EXPONENT OVERFLOW 
(] EXPONENT UNDERFLOW 
C1 FIXED-POINT DIVIDE 

C1 FIXED-POINT OVERFLOW 
CO] FLOATING-POINT DIVIDE 
(CJ OPERATION 


NOT A FLOATING-POINT REGISTER 

OP 1 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON FULL-WORD BOUNDARY 


OP 2 NOT ON DOUBLE-WORD 
BOUNDARY 


OP 1 NOT EVEN NUMBERED REGISTER 
OP 1 NOT ODD NUMBERED REGISTER 
NONE 


Fane RB 


Clif RESULT = 0, SET TOO 


Clif RESULT <0, SET TO1 
OF RESULT >0, SET TO 2 
CIF OVERFLOW, SET TO 3 
BBUNCHANGED 


OOO OOoO0O0 





The move immediate (MVI) instruction places the one byte of immediate data in operand 2 
into one byte of operand 1 located in main storage. 


Explicit Format: 






A OPERATION A OPERAND 


[symbol] 


Implicit Format: 





A OPERATION A OPERAND 


The data in operands 1 and 2 can be defined in any format. The length of operand 1 can 
vary but the length of operand 2 is always one byte. Although operands 1 and 2 can have 
differing lengths, only one byte in operand 1 receives the immediate data from operand 2. 
If you do not specify the exact byte in operand 1 you want to receive the operand 2 data, 
the first byte of operand 1 is used. 

Operational Considerations: 

= Operand 1 must be a main storage location. 

=  Operand 2 must be a 1-byte, self-defining term. 


& §8The length of operand 1 can vary. 


= You can specify the exact byte in operand 1 you want to receive the immediate data 
in operand 2 by relative addressing. 
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Example: 
LABEL AOPERATIONA OPERAND 
1 10 16 
MVI OUTPUT ,X' 46! 
MVC OUTPUT+1 (7) ,OUTPUT 
OUTPUT DS CL8 


OUTPUT before execution of MVI instruction: 


0000 | 0000 | 0000 ;0000 }0000 ,0000 


leftover data from previous program 


















1100! 1010/0100 |1100 


binary 
hex 


Operand 2 immediate before and after execution of MVI instruction: 


0100 ; 0000 : 
binary 


OUTPUT after execution of MVI instruction: 


110011010 }0100|1100 ; 
binary 





only byte changed 


OUTPUT after execution of MVC instruction: 


0100 |0000 |0100 10000 , 
binary 


hex 





In this example, the one byte of immediate data in operand 2 is placed in the first byte of 
OUTPUT since no exact byte is specified. Then that first byte of OUTPUT is propagated 
through that entire field. The length attribute (in this example, 7) can be either implied or 
explicit and determines the number of bytes that the first byte is propagated through. 
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12.17. OR (O) 
OBJECT 
OPCODE FORMAT | INST. 
TYPE LGTH. 
MNEM. (BYTES) 


Condition Codes 


Ml iF RESULT = 0, SET TOO 





Possible Program Exceptions 






Ml ADDRESSING @ PROTECTION 

C1 DATA (INVALID SIGN/DIGIT) | [] SIGNIFICANCE 

(DECIMAL DiviDE MI SPECIFICATION: 

C0 DECIMAL OVERFLOW NOT A FLOATING-POINT REGISTER 
OO execute OP 1 NOT ON HALF-WORD BOUNDARY 





0 ExPONENT OVERFLOW OP 2 NOT ON HALF-WORD BOUNDARY 
CO) EXPONENT UNDERFLOW OP 2 NOT ON FULL-WORD BOUNDARY 
OC FIXED-POINT DIVIDE OP 2 NOT ON DOUBLE-WORD 

DD FIXED-POINT OVERFLOW BOUNDARY 

C0 FLOATING-POINT DIVIDE OP 1 NOT EVEN NUMBERED REGISTER 


(] OPERATION OP 1 NOT ODD NUMBERED REGISTER 
NONE 


Wir RESULT #0, SET TO1 
Cir RESULT > 0, SET TO 2 
Ctr OVERFLOW, SET TO 3 
(J UNCHANGED 





The or (O) instruction performs a logical OR operation (sometimes referred to as an 
inclusive OR operation) on the contents of the operand 1 register and the full word in 
operand 2. The result is placed in the operand 1 register. 


Explicit Format: 








A OPERATION A OPERAND 





LABEL 


[symbol] rd, (x, ,b,) 


Implicit Format: 





A OPERATION A OPERAND 


When the O instruction is executed, a logical OR operation is performed on a bit in 
operand 1 and a bit in operand 2. The result of that OR operation replaces the accessed bit 
in operand 1. This instruction operates from left to right starting with the logical OR 
operation of bit O in both operands up to and including the logical OR operation of bit 31 
in both operands. 
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The O instruction is used to modify bits in the receiving field. The procedure is shown in 
the following truth table: 


Result 
Operand 1 | Operand 2 | (Qperand 1) 


0 
1 
1 
1 


When coding patterns are used as operands in logical OR instructions, the following codes 
are set: 









# 0 in all bit positions in operand 2 that correspond to bit positions in operand 1 that 
you want to remain the same. 


= 1 in all bit positions in operand 2 that correspond to bit positions in operand 1 that 
you want to set to 1. 


After the O instruction is executed, the condition code is set as follows: 
To O if result is all O’s 
To 1 if result is a combination of 1’s and O's. 
Operational Considerations: 
= Any of the general registers (0 through 15) can be used as operand 1. 
= Operand 2 must be either defined as a full word or aligned on a ful-word boundary. 


= ~=§=6©The condition code is set accordingly. 





Example: 
LABEL AOPERATIONA OPERAND 
1 10 16 
L 11,NUMX 
0 11,PATRNO 
DS OF 
NUMX DC X' SOOOFOFD' 


PATRNO 0C X'SOFFOFOF' 
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Register 11 before execution of O instruction: 


0000 10000 |0000 | 0000 | 1111 ;0000 
Rare aa 


PATRNO before and after execution of O instruction: 


000011111 {/0000;1111 
Eee Raa 


Register 11 after execution of O instruction: 


OQO000 | OOOO | 414441199 11991 519191 119911711 
foie lefe[eie[ete 










binary 
hex 











binary 
hex 










binary 
hex 


In this example, the content of NUMX is loaded into register 11 and then a logical OR 
operation is performed on the content of register 11 and the content of PATRNO. The 
resultant modified binary string replaces register 11. 
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oc 


12.18. OR (OC) 


Possible Program Exceptions 
@ReOGE es ADDRESSING W@ PROTECTION 
FORMAT | INST. 
VRE LOTH. (0 DATA (INVALID SIGN/DIGIT) | () SIGNIFICANCE 


(ayTes) || 1) DECIMAL DIVIDE OC) SPECIFICATION: 

NOT A FLOATING-POINT REGISTER 
OP 1 NOT ON HALF-WORD BOUNDARY 
OP.2 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON FULL-WORD BOUNDARY 


OP 2 NOT ON DOUBLE-WORD 
BOUNDARY 


OP 1 NOT EVEN NUMBERED REGISTER 
OP 1 NOT ODD NUMBERED REGISTER 


D DECIMAL OVERFLOW 
O ExecuTE 


(1 EXPONENT OVERFLOW 
Wir Result = 0,S€T TOO C) FiXED-POINT DIVIDE 
Wl if RESULT £0, SET TO 1 C FIXED-POINT OVERFLOW 
DIF RESULT >O, SET TO 2 (CD FLOATING-POINT DIVIDE 


(1F OVERFLOW, SET TO 3 DD OPERATION 
(CO UNCHANGED 


O 
O 
O) 
O 
O 
D 
O 
O 


NONE 





The or (OC) instruction performs a logical OR operation (sometimes referred to as an 
inclusive OR operation) on the contents of operands 1 and 2 located in main storage. The 
result is placed in operand 1. 


Explicit Format: 










AOPERATIONA OPERAND 





LABEL 





[symbol] d, (1,b,),d,(b,) 


Implicit Format: 






A OPERATION A 


OPERAND 


When the OC instruction is executed, a logical OR operation is performed on a bit in 
operand 1 and a bit in operand 2. The result of the logical OR operation replaces the 
accessed bit in operand 1. This instruction operates from left to right. The length of 
operand 1, whether implied or explicit, determines the length of operand 2. Therefore, 
when the OC instruction is executed, the lengths of operands 1 and 2 are the same. 
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& The OC instruction is used to modify bits in the receiving field. The procedure is shown in 
the following truth table: 


Result 
Operand 1 Operand 2 | (Operand 1) 





When coding patterns are used as operands in logical OR instructions, the following codes 
are set: 


= 0 in all bit positions in operand 2 that correspond to bit positions in operand 1 that 
you want to remain the same. 


= 1 in all bit positions in operand 2 that correspond to bit positions in operand 1 that 
you want to set to 1. 


After the OC instruction is executed, the condition code is set as follows: 
@ To O if result is all O's. 
To 1 if result is a combination of 1’s and O's. 
Operational Considerations: 
= Operands 1 and 2 must be located in main storage. 
m The condition code is set accordingly. 


= Operands 1 and 2 can have overlapping bytes. 





Example: 
LABEL AOPERATIONA OPERAND 
1 10 16 
oc CONSTANT, CONDITI 
oc CONSTANT , CONDIT2 
CONSTANT DC B'S6SSAGG6' 
@ CONDIT] DC B'gg0eg11' 


CONDIT2 DC B'GS181988' 
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CONSTANT before execution of OC instruction: 


0000 | 0000 : 
binary 


hex 


Before and after execution of OC instruction: 


CONDIT1 CONDIT2 


0000 |0011 001011000 : 
binary 


hex 


CONSTANT after execution of first OC instruction: 


0000 ,0011 iy 


hex 


CONSTANT after execution of second OC instruction: 


001011011 binary 


hex 


In this example, a logical OR operation is performed on the contents of CONSTANT and 
CONDIT1 and the result is placed in CONSTANT. Then, another logical OR operation is 
performed on the contents of CONSTANT (now modified) and CONDIT2. That result 
replaces the contents of CONSTANT. This is an example of the way programmed switches 
can be used to set several conditions. 
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Ol 


12.19. OR (Ol) 








Possible Program Exceptions 

























ee 
ADDRESSING @ PROTECTION 
Gee Ferd [1] DATA (INVALID SIGN/DIGIT)| [] SIGNIFICANCE 
(Bytes) || [J DECIMAL OlviDE C] SPECIFICATION: 










(0 DECIMAL OVERFLOW 

OO Execute 

(J EXPONENT OVERFLOW 
C] ExPONENT UNDERFLOW 
OD FIXED-POINT DIVIDE 

0 F!IxXED-POINT OVERFLOW 
C1 FLOATING-POINT DIVIDE 
(D0 OPERATION 


NOT A FLOATING-POINT REGISTER 

OP 1 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON FULL-WORD BOUNDARY 


OP 2 NOT ON DOUBLE-WORD 
BOUNDARY 


OP 1 NOT EVEN NUMBERED REGISTER 
OP 1 NOT ODD NUMBERED REGISTER 
NONE 


Condition Codes 


MiF RESULT = 0,SET TOO 


@ if Result #0,seTTO1 
Cir RESULT > 0, SET TO 2 
CIF OVERFLOW, SET TO 3 
CIUNCHANGED 


OOO OoOoOO0O 





The or immediate (Ol) instruction performs a logical OR operation on the contents of 
operand 1 located in main storage and the one byte of immediate data in operand 2. The 
result replaces one byte in operand 1. 


Explicit Format: 









LABEL A OPERATION A 





OPERAND 


[symbol] 


Implicit Format: 






AOPERATION A OPERAND 


[symbol] 


When the OI instruction is executed, a logical OR instruction is performed on a bit in 
operand 1 and a bit in operand 2. The result of the logical OR operation replaces the 
accessed bit in operand 1. This instruction operates from left to right. The length of 
operand 1 can vary but the length of operand 2 is always one byte. Although operands 1 
and 2 may have differing lengths, only one byte in operand 1 is used in the logical OR 
operation. The result replaces the one byte in operand 1 that was accessed. If you do not 
specify the exact byte in operand 1 you want used in the logical OR operation, the first 
byte of operand 1 is used. 
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The Ol instruction is used to modify bits in the receiving field. The procedure is shown in 
the following truth table. 


Result 
Operand 1 | Operand 2 oe: 1) 


0 

1 5 
0 1 
1 1 


When coding patterns are used as operands in logical OR instructions, the following codes 
are set: 









# 0 in all bit positions in operand 2 that correspond to bit positions in operand 1 that 
you want to remain the same. 


a 1 in all bit positions in operand 2 that correspond to bit positions in operand 1 that 
you want to set to 1. 


After the Ol instruction is executed, the condition code is set as follows: 


To O if result is all O's. 





To 1 if result is a combination of 1’s and O's. 
Operational Considerations: 
= Operand 1 must be a main storage location. 
= Operand 2 must be a 1-byte self-defining term. 
= = =§=6The length of operand 1 can vary. 
= The condition code is set accordingly. 


= You can specify the exact byte in operand 1 you want used in the logical OR 
operation through relative addressing. 
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Example: 

LABEL AOPERATIONA OPE RAND 
1 10 16 

AP AMTP , VAL 

UNPK AMT (5) , AMTP 

0! AMT+4,X' FQ! 
AMTP pc PL3'652! 
VAL pc P'522! 
AMT DS ZL5 


AMT before execution of Ol instruction: 


AMT+4 


411110111] 1100 ;0100 F 
binary 


Operand 2 immediate before and after execution of Ol instruction: 


111110000 : 
binary 


AMT after execution of Ol instruction: 








In this example, the packed decimal contents of AMTP and VAL are added together and 
the result is placed in AMTP. Then the UNPK instruction changes the packed format of 
AMITP to the zoned decimal format and puts the result in AMT. In order to print a decimal 
number, it must be in zoned decimal format and each number must be preceded by a 
hexadecimal F. Otherwise, an alpha character will be printed as the rightmost byte. Note 
that the last byte in AMT has a hexadecimal C in its zone portion. The Ol instruction 
allows a logical OR operation to be performed on the contents of byte 5 in AMT and the 
one byte of data in operand 2. The result replaces byte 5 of AMT. Now the decimal 
number in AMT can be printed. 
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OR 


12.20. OR (OR) 









Possible Program Exceptions 









OBJECT || (ADDRESSING OC PROTECTION 
OPCODE | FORMAT | INST. 
RUEE nee C] DATA (INVALID SIGN/DIGIT) | [] SIGNIFICANCE 
(Bytes) || (J) OECIMAL DiviDE Cl sPECIFICATION: 


CZ DECIMAL OVERFLOW 

OC Execute 

CJ EXPONENT OVERFLOW 
DD EXPONENT UNDERFLOW 
CO FIXED-POINT DIVIDE 

CJ FIXED-POINT OVERFLOW 
CZ FLOATING-POINT DIVIDE 
(CJ OPERATION 


NOT A FLOATING-POINT REGISTER 

OP 1 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON FULL-WORD BOUNDARY 


OP 2 NOT ON DOUBLE-WORD 
BOUNDARY 


OP 1 NOT EVEN NUMBERED REGISTER 
OP 1 NOT ODD NUMBERED REGISTER 


Condition Codes 


Mit RESULT = 0,SET TOO 


@ iF RESULT #0, SET TO1 

LJiF RESULT >0, SET TO 2 

CJiF OVERFLOW, SET TO 3 
| IJUNCHANGED 





MoO OooOoo00 


2 
° 
z 
m 





The or (OR) instruction performs a logical OR operation on the contents of the operand 1 
register and operand 2 register. The result is placed in the operand 1 register and also 
determines the setting of the condition code, bits 34 and 35 of the PSW. (See 8.1.) 


Explicit and Implicit Format: 





A OPERATION A OPERAND 


When the OR instruction is executed, a logical OR operation is performed on a bit in the 
operand 1 and operand 2 registers. The result of the logical OR operation replaces the 
accessed bit in operand 1. This instruction operates from left to right starting with the 
execution of the logical OR operation on bit O in both registers up to and including bit 31 
in both registers. 


The OR instruction is used to modify bits in the receiving field. The procedure is shown in 
the following truth table: 







Result 
(Operand 1) 
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When coding patterns are used as operands in logical OR instructions, the following codes 
are set: 


= Qin all bit positions in operand 2 that correspond to bit positions in operand 1 that 
you want to remain the same. 


a 1 in all bit positions in operand 2 that correspond to bit positions in operand 1 that 
you want to set to 1. 


After the OR instruction is executed, the condition code is set as follows: 
To O if result is all O's. 
To 1 if result is a combination of 1’s and 0's. 
Operational Considerations: 
= ~=Any of the general registers (0 through 15) can be used as operands 1 and 2. 


= The condition code is set accordingly. 





Example: 
LABEL AOPERATIONA OPERAND 
] 10 16 
L k ,HEX# 
L 8 ,HEX#2 
OR 4,8 
DS OF 
HEX#1 DC X'G6G1g1cs! 
HEX#2 DC X'SCHABFFS' 


Register 4 before execution of OR instruction: 


0000 |0001 | 11000000 binaty 
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Register 8 before and after execution of OR instruction: 


Register 4 after execution of OR instruction: 


So 


In this example, the content of HEX#1 is loaded into register 4 and the content of HEX#2 
is loaded into register 8. Then a logical OR operation is performed on the contents of 
registers 4 and 8. The result replaces the content of register 4. 





binary 
hex 














binary 
hex 
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SLL 


12.21. SHIFT LEFT SINGLE LOGICAL (SLL) 


OBJECT 
INST. 
LGTH. 
(BYTES) 


Condition Codes 


Cif RESULT = 0,SET TOO 













(] ADDRESSING CJ PROTECTION 

CO DATA (INVALID SIGN/DIGIT) | [] SIGNIFICANCE 
(C DECIMAL DiviDE OC sPeciFICATION: 
C1) DECIMAL OVERFLOW 
CO ExecuTE 


OPCODE | FORMAT 
TYPE 





NOT A FLOATING-POINT REGISTER 

OP 1 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON FULL-WORD BOUNDARY 


OP 2 NOT ON DOUBLE-WORD 
BOUNDARY 


OP 1 NOT EVEN NUMBERED REGISTER 
OP 1 NOT ODD NUMBERED REGISTER 


(J EXPONENT OVERFLOW 
() EXPONENT UNDERFLOW 
C1 FIXEO-POINT DIVIDE 

CO FIXED-POINT OVERFLOW 
C] FLOATING-POINT DIVIDE 
CJ OPERATION 


OliF REsuLT <0, SET TO 1 
Or RESULT >O, SET TO2 
CIF OVERFLOW, SET TO 3 
GUNCHANGED 


MOO Oooo0 


2 
le] 
2 
m 





The shift left single logical (SLL) instruction shifts all of the 32 bits in the operand 1 
register to the left the number of bits specified by the low order six bits of the operand 2 
address. 


Explicit Format: 






A OPERATION A OPERAND 


[symbol] 


Implicit Format 








LABEL AOPERATIONA 


OPERAND 





The operand 2 address is not used to address data. The low order six bits are used as the 
shift count and the remainder of the address is ignored. When the SLL instruction is 
executed, the high order bits that are shifted out of the register are lost and replaced with 
subsequent bits within the register also being shifted. Zeros fill the vacated low order bit 
positions. 


Operational Considerations: 
= Any of the general registers (0 through 15) can be used as operand 1. 


= ~=If you already know the displacement value associated with a label in your program, 
you can use the low order six bits as the shift count. 


= A self-defining term can be specified for operand 2. 
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# Zeros fill the vacated low order bit positions in the operand 1 register. 
= The condition code remains unchanged. 
= A length attribute cannot be specified for operand 2. 


= The shift count cannot exceed 32 bits because the highest value that can be 
represented in the low order six bits is +32 (25). 





Example: 
LABEL AOPERATIONA OPERAND 
] 10 16 
L 4, FLWRD 
SLL 4 , STORAGE 
DS OF 
FLWRD pc X'89ABCDEF' 
STORAGE EQU 8 





Register 4 before execution of SLL instruction: 


binary 
hex 





STORAGE before and after execution of SLL instruction: 


low order six bits 


=—,_- 
0000 ,0000 |0000 ;1000 


location counter (address) 
not contents 


binary 
hex 





Register 4 after execution of SLL instruction: 


binary 
hex 
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In this example, the content of FLWRD is loaded into register 4. Then the SLL instruction 
uses the low order six bits of the address of STORAGE (not content) as the shift count. In 
this case, STORAGE has no content but has been equated with or contains the address of 
the absolute value of 8. When the SLL instruction is executed, eight high order bits of 
register 4 are shifted out of the register, and replaced with subsequent bits within the 
register also being shifted. Zeros fill the vacated eight low order bit positions. 





Example: 
LABEL AOPERATIONA OPERAND 
1 10 16 
SR 4k 
L 4 =F '2566' 
L 5,=F'1p! 
SLL 4 (5) 


Register 4 before execution of SLL instruction: 


0000 | 0000 | 0000 ) 0000 | 0000 | 1001 | 1100 ;0100 - 
binary 


Register 5 before and after execution of SLL instruction: 








actual contents 


Register 4 after execution of SLL instruction: 


0000 ,0000 | 0010 ;0111 10001 {0000 | 0000 ;0000 
Ea aa ee 


In this example, register 4 is cleared to O. The decimal value of 2500 is loaded into 
register 4, and the decimal value of 10 is loaded into register 5. The actual content of 
register 5 is used (not its address) because register 5 is being used as a base register. So, 
the value loaded into register 5 is treated as an address. This can only be done in the 
explicit format. 






binary 
hex 
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SRL 


12.22. SHIFT RIGHT SINGLE LOGICAL (SRL) 


Possible Program Exceptions 


[] ADDRESSING DD PROTECTION 

(1 DATA (INVALID SIGN/DIGIT) | [] SIGNIFICANCE 

(CD DECIMAL Divide CO sPeciFICATION: 

(J DECIMAL OVERFLOW NOT A FLOATING-POINT REGISTER 

0 EXECUTE OP 1 NOT ON HALF-WORD BOUNDARY 
(0 EXPONENT OVERFLOW OP 2 NOT ON HALF-WORD BOUNDARY 
C1 EXPONENT UNDERFLOW OP 2 NOT ON FULL-WORD BOUNDARY 
C1 FIX€ED-POINT DIVIDE OP 2 NOT ON DOUBLE-WORD 

OO FIXED-POINT OVERFLOW BOUNDARY 

C FLOATING-POINT DIVIDE OP 1 NOT EVEN NUMBERED REGISTER 
C oreration OP 1 NOT ODD NUMBERED REGISTER 

NONE 












OBJECT 
OPCODE FORMAT | INST. 
























Condition Codes 


Olir RESULT = 0,SET TOO 
Olie RESULT <0, SET TO1 
Or RESULT >0, SET TO 2 
CIF OVERFLOW, SET TO 3 
@ UNCHANGED 
















Moo ooooo 






The shift right single logical (SRL) instruction shifts all of the 32 bits in the operand 1 
register to the right the number of bits specified by the low order six bits of the operand 2 
address. 


Explicit Format: 









LABEL A OPERATION A 


[symbol] 





OPERAND 


Implicit Format: 








LABEL A OPERATION A 


OPERAND 





The operand 2 address is not used to address data. The low order six bits are used as the 
shift count and the remainder of the address is ignored. When the SRL instruction is 
executed, the low order bits that are shifted out of the register are lost and replaced with 
subsequent bits within the register also being shifted. Zeros fill the vacated high order bit 
positions. 

Operational Considerations: 

= Any of the general registers (0 through 15) can be used as operand 1. 

= Using a label as operand 2 can cause unpredictable results. 

# A self-defining term can be used as operand 2. 


= Zeros fill the vacated high order bit positions in the operand 1 register. 


= §=The condition code remains unchanged. 

















UP-8061 Rev. 3 SPERRY UNIVAC OS/3 12—61 
ASSEMBLER 





@ = 6A length attribute cannot be specified for operand 2. 


# The shift count cannot exceed 32 bits because the highest value that can be 
represented in the low order six bits is +32 (25). 





Example: 
LABEL AOPERATIONA OPERAND 
1 10 16 
L 4 ,WORD 
SRL 4 LABEL 
DS OF 
WORD DC X'3A690G06' 
LABEL DC PL2'9! 


Register 4 before execution of SRL instruction: 


binary 
hex 





location counter 


Register 4 after execution of SRL instruction: 


0000 0000 |ooo0 {0000 {0000 ,0011 | 1010 ;0110 
fo to fo ts [a te | 


In this example, the content of WORD is loaded into register 4. Then the SRL instruction 

uses the low order six bits of the address location counter of LABEL as the shift count. 

You should already know the displacement value of LABEL. That value should be the 

number of bits you want to shift to the right. When the SRL instruction is executed, 20 

low order bits of register 4 are shifted out of the register, and replaced with subsequent 

bits within the register also being shifted. Zeros fill the vacated 20 high order bits. This is 
@ what LABEL looks like when assembled: 






binary 
hex 





LOC. OBJECT CODE LINE SOURCE STATEMENT 


000014 000C 14 LABEL bc PL2'0O! 
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STC 


12.23. STORE CHARACTER (STC) 


Possible Program Exceptions 


MB ADDRESSING @ PROTECTION 







OBJECT 











OPCODE 
pe pee pede (0 DATA (INVALID SIGN/DIGIT)| [] SIGNIFICANCE 
| mem. [HEX,| (Bytes) || 1) DECIMAL DiviDE D SPECIFICATION: 


2 DECIMAL OVERFLOW NOT A FLOATING-POINT REGISTER 
O ExecuTE ‘ OP 1 NOT ON HALF-WORD BOUNDARY 


| ste | az] rx | 4 | 
Condition Codes 


CF RESULT = 0, SET TOO 


C0 EXPONENT OVERFLOW OP 2 NOT ON HALF-WORD BOUNDARY 
0 exPONENT UNDERFLOW OP 2 NOT ON FULL-WORD BOUNDARY 
(0 FIXED-POINT DIVIDE OP 2 NOT ON DOUBLE-WORD 


DO FIxED-POINT OVERFLOW BOUNDARY 
(C0 FLOATING-POINT DIVIDE OP 1 NOT EVEN NUMBERED REGISTER 


1 oPeRATION OP 1 NOT ODD NUMBERED REGISTER 
NONE 


Or RESULT <o, SET TO1 
Cir RESULT >0, SET TO 2 
CIF OVERFLOW, SET TO 3 
BBEUNCHANGED 





The store character (STC) instruction places the low order eight bits (bit positions 24 
through 31) of the operand 1 register into one byte of operand 2 that is located in main 
storage. 


Explicit Format: 






A OPERATION A OPERAND 





| [symbol] r, d(x, ,b,) 


Implicit Format: 









LABEL A OPERATION A OPERAND 


[symbol] 


The data in operand 2 can be defined in any format. The length of operand 2 can vary but 
the length of operand 1 is always four bytes. Although operands 1 and 2 can have the 
same or differing length, only one byte in operand 2 receives the rightmost byte from the 
operand 1 register. If you do not specify the exact byte in operand 2 to receive the operand 
1 data, the first byte of operand 2 is used. 


Operational Considerations: 
= @6Any of the general registers (0 through 15) can be used as operand 1. 


= Operand 2 must be a main storage location. 
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= §«The length of operand 2 can vary. 
= You can specify the exact byte in operand 2 to receive the rightmost byte of the 
operand 1 register through relative addressing. 
= This instruction is one of the few in which operand 1 is the sending operand. 
Example: 
LABEL AOPERATIONA OPERAND 
1 10 16 
L 11,AMTIN 
A 11,=F'S! 
STC 11,STOR 
AMTIN DC F'2236! 
STOR DC CLA'g! 


STOR before execution of STC instruction: 


1111 | 0000 | 0100] 0000 | 0100; 0000 |0100; 0000 


Register 11 before and after execution of STC instruction: 


0000 | 0000 | 0000 | 0000 | 0000 ; 1000 | 110010001 






binary 
hex 




























binary 
STOR after execution of STC instruction: 
110010001 {0100 0000 |0100 10000 [010010000 . 
binary 


hex 


Core ae cee 


In this example, the content of AMTIN is loaded into register 11. Then a decimal value of 5 
is added to the value already in register 11. This is a method of rounding numbers located 
in registers that will eventually be printed. The STC instruction then places the content of 
the rightmost byte in register 11 into the first byte of STOR. Since the exact byte of STOR 
that is to receive the data from register 11 is not specified, the first byte is used. 
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Ti 


12.24. TEST UNDER MASK (TM) 


OBJECT 
OPCODE FORMAT | INST. 
TYPE LGTH. 


Possible Program Exceptions 


WB ADDRESSING MB PROTECTION 

CD DATA (INVALID SIGN/DIGIT) | C] SIGNIFICANCE 

(1 DECIMAL DivIDE (J SPECIFICATION: 

C DECIMAL OVERFLOW NOT A FLOATING-POINT REGISTER 
[1] execute OP 1 NOT ON HALF-WORD BOUNDARY 
(C0 EXPONENT OVERFLOW OP 2 NOT ON HALF-WORD BOUNDARY 
C) EXPONENT UNDERFLOW OP 2 NOT ON FULL-WORD BOUNDARY 
OC FIXED-POINT DIVIDE OP 2 NOT ON DOUBLE-WORD 


OC FIxXED-POINT OVERFLOW BOUNDARY 
C0 FLOATING-POINT DIVIDE OP 1 NOT EVEN NUMBERED REGISTER 


C1 opeRATION OP 1 NOT ODD NUMBERED REGISTER 
NONE 
























Condition Codes 


M@ set too 
WM settoi 
OO setrto2 
M@ setTo3 
SEE OPER. CONSIDERATIONS 


(BYTES) 


















EY a | 


The test under mask (TM) instruction uses the 1-byte mask in operand 2 to test the bit 
pattern of one byte in operand 1 that is located in main storage. The result of the test 
determines the setting of the condition code, bits 34 and 35 of the PSW. (See 8.1.) 


Explicit Format: 









A OPERATION A 





LABEL OPERAND 


[symbol] 


Implicit Format: 





A OPERATION A 


OPERAND 


Operand 2 is one byte of immediate data that is used as the mask. Within that byte is an 
8-bit binary testing pattern. The bits of the mask correspond one for one to bits in one byte 
of operand 1. The length of operand 1 can vary but the length of operand 2 is always one 
byte. Although the lengths of operands 1 and 2 can differ, only one byte of operand 1 is 
used. If you do not specify the exact byte of operand 1 you want tested, the first byte is 
used. 


A mask bit of one in operand 2 tests its corresponding bit position in operand 1 for the 
presence of one bit or a O bit. 


A mask bit of O in operand 2 causes its corresponding bit position in operand 1 not to be 
tested. If the mask pattern is all O’s, no testing takes place; whereas, if the mask pattern is 
all 1’s, every corresponding bit position in operand 1 is tested. 
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The condition code is set as follows: 


To O if the mask pattern is all O's; or all the corresponding tested bit positions in 
operand 1 are O's. 


To 1 if all the corresponding tested bit positions in operand 1 are a combination of O’s 
and 1's. 


To 3 if all the corresponding tested bit positions in operand 1 are 1's 


Some of the more common uses of the test under mask instruction are in checking the 
setting of program switches and checking for valid characters. These switches are usually 
set by one of the logical OR instructions. After the switches are set, the TM instruction 
uses the mask to test the bit pattern in operand 1 and set the condition code. Then the 
resulting condition code can be used to alter the processing sequence of a program by 
using one of these branch instructions: 


Meaning Condition 
Instruction Instruction 
BOR ’ Branch if 1’s. The branch is taken if all 
the bits tested are on. 


Branch if mixed. The branch is taken if some 
of the bits tested are on, some off. 


Branch if O's. The branch is taken if all of the 
bits are off, or the mask is 0. 


Branch if not The branch is taken if at least 
all 1's. one of the bits tested is not on. 


Branch if not The branch is taken if at least 
all O's. one of the bits tested is not off. 


Branch if not The branch is taken if all the bits 
mixed. tested are off or if all are on. 





Operational Considerations: 

= Operand 1 must be a main storage location. 

= Operand 2 is the mask and is a 1-byte self-defining term. 

s The condition code is set accordingly but condition code 2 is not used. 

a The length of operand 1 can vary but a length attribute cannot be specified. 


= You can specify the exact byte in operand 1 you want the operand 2 mask to test 
through relative addressing. 


= The contents of operand 1 and operand 2 remain unchanged after the execution of 
the TM instruction. 
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Example: 

LABEL AOPERATIONA OPERAND 
1 10 16 

LA 5,PAYHRS 

™ O(5) ,X'Fp! 

BNO ERROR} 

™ 1(5) ,X'FO! 

BNO ERROR2 
ERROR] MVC OUTPUT (26) ,MSGI 
ERROR2 MVC OUTPUT (21) ,MSG2 
PAYHRS DC CL2'4A! 

DS OH 
OUTPUT DS CLI 32 
MSG] Dc CL2@'FIRST NUMBER INVALID! 
MSG2 DC CL21'SECOND NUMBER INVALID! 


PAYHRS before and after execution of first and second TM instruction: 





Operand 2 mask before and after execution of first and second TM instruction: 


1111 j9000 F 
binary 


In this example, the address of PAYHRS is loaded into register 5. The TM instruction then 
uses the mask in operand 2 to test the first byte in operand 1. The four high order bits of 
the mask test the four high order bits of operand 1. (The low order four bits of the mask 
cause no testing of the low order four bits of operand 1 to take place.) Since the result of 
the test is all 1’s, the condition code is set to 3 and no branch takes place. 


The second TM instruction uses the mask in operand 2 to test the second byte in operand 
1. The four high order bits of the mask test the four high order bits of the second byte in 
operand 1. (The low order four bits of the mask cause no testing of the low order four bits 
of operand 1 to take place.) Since the result of the test is a combination of O’s and 1’s, the 
condition code is set to 1 and the branch to the instruction labeled ERROR2 takes place. 
There, an error message is moved to the output area for printing. 
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TR 


12.25. TRANSLATE (TR) 


Possible Program Exceptions 


Mi ADDRESSING W PROTECTION 

(C0 DATA (INVALID SIGN/DIGIT)| [1 SIGNIFICANCE 

( DECIMAL DIVIDE (J SPECIFICATION: 

(CJ DECIMAL OVERFLOW NOT A FLOATING-POINT REGISTER 

O execute OP 1 NOT ON HALF-WORD BOUNDARY 

C0 EXPONENT OVERFLOW OP 2 NOT ON HALF-WORD BOUNDARY 

CO ExPONENT UNDERFLOW OP 2 NOT ON FULL-WORD BOUNDARY 

OO FIXED-POINT DIVIDE OP 2 NOT ON DOUBLE-WORD 

C1 FIxXED-POINT OVERFLOW BOUNDARY 

(C1 FLOATING-POINT DIVIDE OP 1 NOT EVEN NUMBERED REGISTER 

C0 operation OP 1 NOT ODD NUMBERED REGISTER 
NONE 


OBJECT 
OPCODE FORMAT | INST. 


TYPE LGTH. 


MNEM. (BYTES) 


Condition Codes 


Clit RESULT = 0,SET TOO 
Or RESULT <0, SET TO 1 
Olte RESULT >0, SET TO 2 
CIF OVERFLOW, SET TO 3 
UNCHANGED 











The trans/ate (TR) instruction gets a byte from a table of characters in operand 2 and 
places it in its corresponding byte of operand 1. 


Explicit Format: 






A OPERATION A OPERAND 





[symbol] d, (Lb, ),d, (b,) 


Implicit Format: 






AOPERATION A OPERAND 


s, (l),s, 


The translate instruction can translate the bit pattern of each byte in a field (operand 1) to 
any other bit pattern. This instruction works in conjunction with a table (operand 2) that 
has been previously defined within the program, and contains the bit patterns that 
correspond to each byte in operand 1. This instruction operates from left to right, starting 
with the replacement of the leftmost byte in operand 1, and ending with the replacement 
of the rightmost byte in operand 1. To find the appropriate code in the table (operand 2), 
each byte in the operand 1 field is used as an unsigned binary value that is added to the 
address of the first byte in the table. (The sum of the addition is similar to the addition of 
base register and displacement values.) 
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The result of the addition is another address which should be somewhere within the table. 
The one byte of data that is located at that address replaces the 8-bit binary value of 
operand 1 that was used in the addition to arrive at that location. After the first byte is 
replaced, the second byte is operated upon and replaced, and so on until the end of the 
operand 1 field is reached. 


Since there are 256 different combinations of an 8-bit byte (EBCDIC), the maximum size of 
the translate table is 256 bytes. However, you can define a table smaller than that 
because input data is normally restricted to a smaller range. 

The translate instruction can be used to convert data from one code to another code (i.e., 
octal to hexadecimal) or it can be used to rearrange data to be stored in a specific 
sequence. 

Operational Considerations: 

= Operand 1 must be a main storage location and can be defined in any format. 

= Operand 2 must be a table that is previously defined within the program. 

= Operand 2 cannot exceed 256 bytes in length. 


= ~§=©One byte in operand 2 replaces one byte in operand 1. 


= ach byte in operand 1 is treated as an unsigned binary value which is added to the 
address of the first byte in operand 2. 





Example: 

LABEL AOPERATIONA OPERAND 

1 10 16 
TR FIELD, TABLE 

FIELD DC X'66A4C5F7' 

TABLE DS OCL256 
DC 196x' 6p! 
DC X'91 92638465669 76869BA ' 
DC 5Ox'gp' 
1] X' PBOCODGEGF1G111213' 
DC 19x Gp! 
DC X*1T41SI6I7IBISIAIBIC' 
DC 56X'6p' 
DC X'1D1E1F26212223242526' 


DC 4x' gp! 
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FIELD before execution of TR instruction: 


0110 10110} 1010 0100} 110010101 Hratsio114] 
















binary 
FIELD after execution of TR instruction: 
0000 (0011 {000011111 {000010000 /0010;0110 : 
binary 






hex 


In this example, FIELD (operand 1) contains four addresses to be added to the address of 
the first byte of TABLE (operand 2), one at a time, to access a specific byte within the 
table. The table with the label TABLE is defined as part of this program. 


The first byte in operand 1, a hexadecimal 66, has a decimal equivalence of 102. When a 
decimal value of 102 is added to the address of the first byte in TABLE, the 103rd byte in 
the table (a hexadecimal 03), is accessed. That byte replaces the hexadecimal 66 and the 
second byte in operand 1 is processed. 


The second byte in operand 1 (a hexadecimal A4) has a decimal equivalence of 164. When 
a decimal value of 164 is added to the address of the first byte in TABLE, the 165th byte 
in the table (a hexadecimal OF) is accessed. That byte replaces the hexadecimal A4 and 
the third byte in operand 1 is processed. 


The third byte in operand 1 (a hexadecimal C5) has a decimal equivalence of 197. When a 
decimal value of 197 is added to the address of the first byte in TABLE, the 198th byte in 
the table (a hexadecimal OO) is accessed. That byte replaces the hexadecimal C5 and the 
fourth byte in operand 1 is processed. 


The fourth byte in operand 1 (a hexadecimal F7) has a decimal equivalence of 247. When 
a decimal value of 247 is added to the address of the first byte in TABLE, the 248th byte 
in the table (a hexadecimal 26) is accessed. That byte replaces the hexadecimal F7 and the 
TR instruction terminates. 
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TRT 


12.26. TRANSLATE AND TEST (TRT) 


Possible Program Exceptions : 


OBJECT |) gy ADDRESSING HI PROTECTION 


OPCODE | FORMAT | INST 
; N/DI IGNIFICAN 
ORE text (0 DATA (INVALID SiGN/DIGIT)| [) s CANCE 


| mem. [HEX.,| (Bytes) || ) DECIMAL DIVIDE C2 SPECIFICATION: 
(1 DECIMAL OVERFLOW NOT A FLOATING-POINT REGISTER 
| tat | oo] ss | 6 | O execute OP 1 NOT ON HALF-WORD BOUNDARY 


0 EXPONENT OVERFLOW OP 2 NOT ON HALF-WORD BOUNDARY 
Condition Codes C0 EXPONENT UNDERFLOW OP 2 NOT ON FULL-WORD BOUNDARY 


mccrios O FIXED-POINT DIVIDE OP 2 NOT ON DOUBLE-WORD 
@sertoi 0 FIxED-POINT OVERFLOW BOUNDARY 


B SET T02 C0 FLOATING-POINT DIVIDE OP 1 NOT EVEN NUMBERED REGISTER 
Cl set to3 C0 OPERATION OP 1 NOT ODD NUMBERED REGISTER 


SEE OPER. CONSIDERATIONS NONE 





The translate and test (TRT) instruction gets a byte from a table of characters in operand 2 
and examines it for the presence of a hexadecimal OO. If found, it continues processing 
with the next byte in operand 1. If not found, execution of the TRT instruction is 
terminated and the address of that byte in operand 1 and the nonzero byte in the table are 
saved. The result of the byte examination in the table determines the setting of the 
conditon code, bits 34 and 35 of the PSW. (See 8.1.) 





Explicit Format: 






LABEL A OPERATION A OPERAND 


[symbol] d, (I,b,),d,(b,) 


Implicit Format: 









A OPERATION A 





LABEL OPERAND 


s, (1),s, 


This instruction works in conjunction with a table (operand within the program and 
contains bit patterns that correspond to each byte in operand 1. This instruction operates 
from left to right starting with the first byte in operand 1 and ending with the last byte in 
operand 1 or, when a nonzero byte is found in the table. To find the appropriate code in 
the table (operand 2), each byte in the operand 1 field is used as an unsigned binary value 
which is added to the address of the first byte in the table. This method of accessing a 
byte from a table is performed in the same manner as the translate (TR) instruction. @ 
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The result of the addition of an unsigned binary value to the address of the first byte is 
another address which should be somewhere within the table. The one byte of data that is 
located at that address is examined for the presence of a hexadecimal OO. If found, 
processing continues with the next byte in operand 1. If a hexadecimal OO is not found, 
execution of the TRT instruction is terminated. 
The address of that byte in operand 1 is inserted in the low order 24 bits of register 1, 
with the high order eight bits remaining unchanged. The nonzero byte from the table is 
inserted in the low order eight bits of register 2, with the high order 24 bits remaining 
unchanged. 
The condition code is set as follows: 

To O if all the bytes examined in the table are O 


To 1 if a nonzero character is found in the table before the last byte in operand 1 is 
processed 


To 2 if a nonzero character is found in the table that corresponds to the last byte in 
operand 1 


The translate and test instruction is used to find certain characters in an input stream. You 
can set up operand 2 (table) with all O bytes for those characters to be skipped over and all 
nonzero bytes for those characters to be detected and used. 

Operational Considerations: 

= Operand 1 must be a main storage location and can be defined in any format. 

=  Operand 2 must be a table that is previously defined within the program. 


= Operand 2 cannot exceed 256 bytes in length. 


= ach selected byte in the table (operand 2) is examined for the presence of a 
hexadecimal OO. 


= ach byte in operand 1 is treated as an unsigned binary viaue which is added to the 
address of the first byte in operand 2. 


= The condition code is set accordingly. 
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Example: 
LABEL AOPERATIONA OPERAND 
! 10 16 
I a a Nn es 
TRT AREAIN, TRTTABLE 
AREAIN DC X'324648! 
TRTTABLE DS OCL256 
DC 64xX' Gg! 
DC xX'hg' 
DC 191X'6g! 


Register 1 after execution of TRT instruction: 


0000 | 0000 }0000 10000 | 00001 0000 {0100 ,0000 


tl 
address of 
second byte 
in operand 1 






binary 
hex 








Register 2 after execution of TRT instruction: 


0000 ; 0000 | 0000 |0000 |0000{ 0000 |0100 ,0000 Sinaly 
a 


nonzero byte 
in table that 
corresponds to 
second byte in 
operand 1 







In this example, the only nonzero byte in the table is the 65th byte which is the address of 
the first byte in the table +64. The hexadecimal 40 at that location causes the TRT 
instruction to terminate. Then the address of the blank, also a hexadecimal 40, is put into 
register 1. The nonzero character in the table, a blank, is put in the rightmost byte of 
register 2. The condition code is set to 1 since a nonzero character is found in the table 
before the last byte in operand 1 has been processed. 
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13. Privileged and Status Switching 
Instructions 


13.1. GENERAL 


A privileged instruction is an instruction used by the operating system. A privileged 
instruction cannot be used in a program operating under the SPERRY UNIVAC Operating 
System/3 (OS/3). If a program operating under OS/3 uses a privileged instruction, a 
privileged operation program exception causes the program to terminate without 
executing. 


The privileged instructions are included in this book because they can be assembled under 
OS/3 even though they can’t be executed. 


The checkoff table used with each instruction is explained in Appendix D. 


Some of the status-switching instructions are also privileged, but three are not. These 
instructions are set program mask (SPM), supervisor call (SVC), and test and set (TS). 


Since the status switching instructions manipulate portions of the program status word 
(PSW), it might be helpful to read the PSW field description in 8.1. 
13.2. STATUS-SWITCHING PRIVILEGED INSTRUCTIONS 


The status-switching instructions can change the program status word (PSW), the 
contents of the protect key storage, and the current relocation register. 
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HPR 


13.2.1. 


General 


OBJECT 


Halt and Proceed (HPR) 















(J ADDRESSING 
















(1 DECIMAL OVERFLOW 

OO EXECUTE 

(J EXPONENT OVERFLOW 
CO EXPONENT UNOERFLOW 
CD FIXED-POINT DIVIDE 

C] FIXED-POINT OVERFLOW 
C] FLOATING-POINT DIVIDE 
MB OPERATION 


Condition Codes 


Clif RESULT = 0,SET TOO 
Cif RESULT <0, SETTO1 
Clif RESULT >O, SET TO 2 
(J1F OVERFLOW, SET TO3 
BB UNCHANGED 








Explicit Format: 








A OPERATION A 


[symbol] 


HALTHERE 0(5), 81 


Implicit Format: 


SPERRY UNIVAC OS/3 
ASSEMBLER 


Possible Program Exceptions 






OPCODE 
gata Hedi (CD DATA (INVALID SIGN/DIGIT) 
(Bytes) |] (J DECIMAL OlvIDE 


13-2 









(1D PROTECTION 

C1 SIGNIFICANCE 

(0 SPECIFICATION: 

NOT A FLOATING-POINT REGISTER 
OP 1 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON FULL-WORD BOUNDARY 


OP 2 NOT ON DOUBLE-WORD 
BOUNDARY 


OP 1 NOT EVEN NUMBERED REGISTER 
OP 1 NOT ODD NUMBERED REGISTER 
NONE 


























OOO O0Oo000 







OPERAND 







OPERAND 





LABEL A OPERATION A 
[symbol] HPR S, i, 
HPR TAG, X‘FF’ 
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13.2.2. Insert Storage Key (ISK) 


Possible Program Exceptions 


OBJECT |! BB ADDRESSING (1 PROTECTION 


OPCODE FORMAT | INST 
SIGNIFICANCE 
TPE rere CJ DATA (INVALID SIGN/DIGIT)} CO c 


Ane eR (Bytes) ||) DECIMAL DIVIDE W@ SPECIFICATION: 
C1) pecIMAL OVERFLOW 
() Execute 


NOT A FLOATING-POINT REGISTER 

OP 1 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON FULL-WORD BOUNDARY 


OP 2 NOT ON DOUBLE-WORD 
BOUNDARY 


OP 1 NOT EVEN NUMBERED REGISTER 
OP 1 NOT ODD NUMBERED REGISTER 
NONE 


() EXPONENT OVERFLOW 
C0 EXPONENT UNDERFLOW 
CF RESULT = 0, SET TOO SL EAEO POINT RIVIDE 
Olir RESULT <0, SET TO1 CJ FIXED-POINT OVERFLOW 
Cif RESULT > 0, SET TO 2 CJ FLOATING-POINT DIVIDE 


(1F OVERFLOW, SET TO3 Wi OPERATION 
BB UNCHANGED 


OOO OoOoo0o0 





Explicit and Implicit Format: 


LABEL A OPERATION A OPERAND 
[symbol] tails 
INKEY 3,4 
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LCS 





13.2.3. Load Control Storage (LCS) 


General 
OBJECT 
OPCODE FORMAT | INST. 
TYPE LGTH. 


Possible Program Exceptions 


ADDRESSING @ PROTECTION 

(0 DATA (INVALID SIGN/DIGIT) | [] SIGNIFICANCE 

[1] DECIMAL DIVIDE MI SPECIFICATION: 

CO DECIMAL OVERFLOW NOT A FLOATING-POINT REGISTER 
O execute OP 1 NOT ON HALF-WORD BOUNDARY 
(1 EXPONENT OVERFLOW OP 2 NOT ON HALF-WORD BOUNDARY 
CO EXPONENT UNDERFLOW OP 2 NOT ON FULL-WORD BOUNDARY 
(CO FIXED-POINT DIVIDE OP 2 NOT ON DOUBLE-WORD 


CJ FIxED-POINT OVERFLOW BOUNDARY 
(0 FLOATING-POINT DIVIDE OP 1 NOT EVEN NUMBERED REGISTER 


OPERATION OP 1 NOT ODD NUMBERED REGISTER 
NONE 
















jtcs jor] rms | 4 | 


{ Condition Codes 


Mset too 
WMsertoi 
O) set to 2 
MiseTTO3 
CJ UNCHANGED 












OOO OOsOO 





f 


Explicit Format: 







A OPERATION A OPERAND 


[symbol] 





LOD 5, 3, 32(8) 
Implicit Format: 
LABEL A OPERATION A OPERAND 
[symbol] Fan fgs So 
LOD 5,3, TAG4 (2) 
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LPSW 


13.2.4. Load Program Status Word (LPSW) 


Possible Program Exceptions 


Hi ADDRESSING WB PROTECTION 


General 


OBJECT 


















OPCODE 
eked — C1 DATA (INVALID SIGN/DIGIT) | [] SIGNIFICANCE 
(Bytes) || D DECIMAL DIVIDE Wi sPECIFICATION: 


NOT A FLOATING-POINT REGISTER 
OP 1 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON FULL-WORD BOUNDARY 
OP 1 NOT ON DOUBLE-WORD 
BOUNDARY 
OP 1 NOT EVEN NUMBERED REGISTER 
OP 1 NOT ODD NUMBERED REGISTER 
NONE 


(1) DECIMAL OVERFLOW 

OJ execute 

LJ EXPONENT OVERFLOW 
(] EXPONENT UNDERFLOW 
CJ F!X€ED-POINT DIVIDE 

CO FixED-POINT OVERFLOW 
CO FLOATING-POINT DIVIDE 
OPERATION 


Condition Codes 


Msettoo 
MBsettoi 
MM set to2 
MisetTTo3 
[J UNCHANGED 









OOO gwOoo00 





Explicit Format: 





LABEL A OPERATION A OPERAND 
[symbol] LPSW d,(b,),i, 
LODSTAT LPSW 32(16), 00 


Implicit Format: 






A OPERATION A OPERAND 






[symbol] 
LODSTAT 


S., i, 
STORAGE, 00 





UP-8061 Rev. 3 SPERRY UNIVAC OS/3 
ASSEMBLER 


SSK 


13.2.5. Set Storage Key (SSK) 


General Possible Program Exceptions 
OBJECT 
ADDRESSING [1 PROTECTION 
OPCODE FORMAT | INST. a 
TYPE LGTH. 


oO DATA (INVALID S!IGN/DIGIT) O SIGNIFICANCE 


(J DECIMAL OtvVIDE WB SPECIFICATION: 
Tssk [os] nn | 2 O DECIMAL OVERFLOW NOT A FLOATING-POINT REGISTER 
Condition Codes 


OJ execute OP 1 NOT ON HALF-WORD BOUNDARY 
CO EXPONENT OVERFLOW OP 2 NOT ON HALF-WORD BOUNDARY 
C2 EXPONENT UNDERFLOW OP 2 NOT ON FULL-WORD BOUNDARY 

ie eecuee Sea OC FIXED-POINT DIVIDE OP 2 NOT ON DOUBLE-WORD 

Ne RESULT <0, ores OD FIXED-POINT OVERFLOW BOUNDARY 

DF RESULT > 0, SET TO 2 

CF OVERFLOW, SET TO3 

MB UNCHANGED 

























































CJ FLOATING-POINT DIVIDE OP 1 NOT EVEN NUMBERED REGISTER 
BB OPERATION OP 1 NOT ODD NUMBERED REGISTER 
NONE 










OOO OOO00 





Explicit and implicit Format: 









A OPERATION A OPERAND 









[symbol] 
SETKEY 
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SSM 


13.2.6. Set System Mask (SSM) 


OBJECT 
INST. 
LGTH. 
(BYTES) 


Condition Codes 


OIF RESULT = 0,SET TOO 
Clif RESULT <0, SETTO1 
DF RESULT > 0, SET TO 2 
CIF OVERFLOw, SET TO 3 
GBEUNCHANGED 





ME ADDRESSING Wi PROTECTION 

(1) DATA UNVALID SIGN/DIGIT) | () SIGNIFICANCE 
(0 DECIMAL DivIDE Wi SPECIFICATION: 
0) DECIMAL OVERFLOW 
0) ExECUTE 













OPCODE | FORMAT 
TYPE 


NOT A FLOATING-POINT REGISTER 

OP 1 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON FULL-WORD BOUNDARY 


OP 2 NOT ON DOUBLE-WORD 
BOUNDARY 


OP 1 NOT EVEN NUMBERED REGISTER 
OP 1 NOT ODD NUMBERED REGISTER 
NONE 


(C) EXPONENT OVERFLOW 
(C1 EXPONENT UNDERFLOW 
C] FIXED-POINT DIVIDE 

O FixED-POINT OVERFLOW 
C] FLOATING-POINT DIVIDE 
BB OPERATION 


OOO OOOO 





Explicit Format: 


A OPERATION A OPERAND 





Implicit Format: 






A OPERATION A OPERAND 






[symbol] 
SETSM 


$y 
SYSMASK 


13.3. INPUT/OUTPUT PRIVILEGED INSTRUCTION 


There is one privileged instruction that initiates input and output: the start //O (SIO) 
instruction. When the SIO instruction is executed, the processor stops executing 
instructions and waits while input and output routines are using the processing time. 
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SIO 


13.3.1. Start I/O (SIO) 


Possible Program Exceptions 


(J ADDRESSING (C1 PROTECTION 

[] DATA (INVALID SIGN/DIGIT) | [] SIGNIFICANCE 

(] DECIMAL DIVIDE (CJ SPECIFICATION: 

C1 DECIMAL OVERFLOW NOT A FLOATING-POINT REGISTER 
OO execute OP 1 NOT ON HALF-WORD BOUNDARY 
CO EXPONENT OVERFLOW OP 2 NOT ON HALF-WORD BOUNDARY 
LD EXPONENT UNDERFLOW OP 2 NOT ON FULL-WORD BOUNDARY 
C2 FIXED-POINT DIVIDE OP 2 NOT ON DOUBLE-WORD 


C] FIXED-POINT OVERFLOW BOUNDARY 
(] FLOATING-POINT DIVIDE OP 1 NOT EVEN NUMBERED REGISTER 


WB OPERATION OP 1 NOT ODD NUMBERED REGISTER 
NONE 





OBJECT 
OPCODE FORMAT | INST. 


















TYPE LGTH. 
(BYTES) 


Condition Codes 


@setto1 
W@ set to2 
Msetto3 
CJ UNCHANGED 










0OO OoOo000 





Explicit Format: 


A OPERATION A OPERAND 





Implicit Format: 





A OPERATION A 







OPERAND 


[symbol] 


INOUT STORE 


13.4. DIAGNOSTIC PRIVILEGED INSTRUCTIONS 


The diagnostic instructions are diagnose (DIAG), SOFTSCOPE forward scan (SSFS), and 
SOFTSCOPE reverse scan (SSRS). The SOFTSCOPE instructions select and monitor any 
bus wire carrying information to or from a byte of main storage. The diagnose 
instruction resets the processor to O after control storage is loaded. 
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DIAG 


13.4.1. Diagnose (DIAG) 









Possible Program Exceptions 


[] ADDRESSING O) PROTECTION 


OBJ ee 







ea C] DATA (INVALID SIGN/DIGIT)| [] SIGNIFICANCE 
| MNEM. [HEX. (Bytes) |] CO] DECIMAL DIVIDE @ SPECIFICATION: 






OPCODE | FORMAT 
TYPE 
Condition Codes 


‘Bir RESULT = 0,SETTOO 
LJif RESULT <0,SETTO1 
Oe RESULT >0, SET TO 2 
CIF OVERFLOW, SET TO 3 
(UNCHANGED 


NOT A FLOATING-POINT REGISTER 

OP 1 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON FULL-WORD BOUNDARY 


OP 2 NOT ON DOUBLE-WORD 
BOUNDARY 


OP 1 NOT EVEN NUMBERED REGISTER 
OP 1 NOT ODD NUMBERED REGISTER 
NONE 


(1) DECIMAL OVERFLOW 

CO] execute 

OC) ExPONENT OVERFLOW 
C1 EXPONENT UNDERFLOW 
D0 FIXED-POINT DIVIDE 

0 FIXED-POINT OVERFLOW 
(1) FLOATING-POINT DIVIDE 
HE OPERATION 







OOO oOo000 






Explicit Format: 





OPERAND 






A OPERATION A 







[symbol] 
SETZERO 


d, (b, ), 
32(6), 00 


Implicit Format: 





A OPERATION A OPERAND 







[symbol] 
SETZERO 


$,,4 
STORAGE, 00 
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SSFS 


13.4.2. SOFTSCOPE Forward Scan (SSFS) 


Possible Program Exceptions 


i ADDRESSING PROTECTION 















OBJECT 




























OPCODE |} FoRMAT | INST 
I IGNIFI 
TYPE LGTH. (J DATA (INVALID SIGN/DIGIT) | (] SIGNIFICANCE 
MNEM. (Bytes) || [J DECIMAL OlviDE Wl SPECIFICATION: 


0] DECIMAL OVERFLOW 

OJ execute 

CJ EXPONENT OVERFLOW 
(J EXPONENT UNDERFLOW 
OO FIXED-POINT DIVIDE 

CO FIxXED-POINT OVERFLOW 
C0 FLOATING-POINT DIVIDE 
W OPERATION 


NOT A FLOATING-POINT REGISTER 

OP 1 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON FULL-WORD BOUNDARY 


OP 2 NOT ON DOUBLE-WORD 
BOUNDARY 


OP 1 NOT EVEN NUMBERED REGISTER 
OP 1 NOT ODD NUMBERED REGISTER 
NONE 






Condition Codes 


MseT TOO 
Ol setrto1 
0) set To 2 
Wsetto3 
[LJ UNCHANGED 

























OOmg oO0000 


Explicit and Implicit Format: 


The bit pattern is the format of the instruction. 
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SSRS 


13.4.3. SOFTSCOPE Reverse Scan (SSRS) 


General Possible Program Exceptions 
OBJECT 
OPCODE FORMAT | INST. 
TYPE LGTH. 


MNEM. }HEX. «(BYTES) 







ADDRESSING @ PROTECTION 

( DATA (INVALID SIGN/DIGIT)| [] SIGNIFICANCE 

(J DECIMAL DIVIDE Wi SPECIFICATION: 

(1 DECIMAL OVERFLOW NOT A FLOATING-POINT REGISTER 












CO execute OP 1 NOT ON HALF-WORD BOUNDARY 
(] EXPONENT OVERFLOW OP 2 NOT ON HALF-WORD BOUNDARY 
(] EXPONENT UNDERFLOW OP 2 NOT ON FULL-WORD BOUNDARY 
C2 FIXED-POINT DIVIDE OP 2 NOT ON DOUBLE-WORD 
ee OD FIXED-POINT OVERFLOW BOUNDARY 
BM set t02 C] FLOATING-POINT DIVIDE OP 1 NOT EVEN NUMBERED REGISTER 
MsetTo3 @ OPERATION OP 1 NOT ODD NUMBERED REGISTER 


(J UNCHANGED NONE 





Explicit and Implicit Format: 


The bit pattern is the format of the instruction. 


13.5. INTERNAL TIMER PRIVILEGED INSTRUCTION 


The OS/3 hardware contains an internal timer register that is controlled by the service 
timer register (STR) instruction. 
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STR 


13.5.1. Service Timer Register (STR) 










Possible Program Exceptions 
OPCODE Ke —_" (ADDRESSING Flesorection 
mo] VE Beans CO DATA (INVALID SIGN/DIGIT)| [] SIGNIFICANCE 
| mnem. [HEx. | (Bytes) ||) DECIMAL DIVIDE Wi SPECIFICATION: 


CJ DECIMAL OVERFLOW NOT A FLOATING-POINT REGISTER 
0 execute : OP 1 NOT ON HALF-WORD BOUNDARY 







| sta [os] am | 2 
Condition Codes 


@set too 
Msettoi 
@Msetto2 
Miser 103 
CO UNCHANGED 


C1 EXPONENT OVERFLOW OP 2 NOT ON HALF-WORD BOUNDARY 
OO EXPONENT UNDERFLOW OP 2 NOT ON FULL-WORD BOUNDARY 
(J FIXED-POINT DIVIDE OP 2 NOT ON DOUBLE-WORD 


C1 FIXeD-POINT OVERFLOW BOUNDARY 
CD FLOATING-POINT DIVIDE OP 1 NOT- EVEN NUMBERED REGISTER 


OPERATION OP 1 NOT ODD NUMBERED REGISTER 
NONE 








Explicit and Implicit Format: 






A OPERATION A OPERAND 


[symbol] 
TIMREG 






5,6 
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@ SLM 


13.6. GENERAL REGISTER PRIVILEGED INSTRUCTIONS 


These instructions operate on the problem general register set. 


13.6.1. Supervisor Load Multiple (SLM) Instruction 


Possible Program Exceptions 


@ AODRESSING @ PROTECTION 






OBJECT 













OPCODE \ 
ee ee C1 DATA (INVALID SIGN/DIGIT) | [) SIGNIFICANCE 
(Bytes) || D OECIMAL DIVIDE 2 SPECIFICATION: 





0 DECIMAL OVERFLOW 

O execute 

0 ExPONENT OVERFLOW 
0 EXPONENT UNDERFLOW 
(C0 FIXED-POINT DIVIDE 

0 FIxED-POINT OVERFLOW 
C0 FLOATING-POINT DIVIDE 
OPERATION 


NOT A FLOATING-POINT REGISTER 

OP 1 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON FULL-WORD BOUNDARY 


OP 2 NOT ON DOUBLE-WORD 
BOUNDARY 


OP 1 NOT EVEN NUMBERED REGISTER 
OP 1 NOT ODD NUMBERED REGISTER 
NONE 


ram [ol as | «| 
Condition Codes 


Cir RESULT = 0, SET TOO 
Dir RESULT <0, SET TO1 
Or RESULT > 0, SET TO 2 
CIF OVERFLOW, SET TO 3 
BB UNCHANGED 


OOO Ow8O00 





Explicit Format: 







A OPERATION A OPERAND 


{symbol} 


11.13 dz (bo) 
LOAD36 


3,6,20(9) 


Implicit Format: 






A OPERATION A OPERAND 






[symbol] 


14.13 S2 
LOAD36 


3,6,DATAFIVE 
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SSTM 


13.6.2. Supervisor Store Multiple (SSTM) Instruction 


Possible Program Exceptions 


Wi ADDRESSING @ PROTECTION 







OBJECT 











OPCODE 
seve’ Wey (] DATA (INVALID SIGN/DIGIT)| [] SIGNIFICANCE 
(Bytes) |] DJ DECIMAL DIVIDE CO SPECIFICATION: 


C DECIMAL OVERFLOW 

OC) execute 

CJ EXPONENT OVERFLOW 
CD EXPONENT UNDERFLOW 
CD FIXED-POINT DIVIDE 

C1 FIXED-POINT OVERFLOW 
CO) FLOATING-POINT DIVIDE 
BB OPERATION 


NOT A FLOATING-POINT REGISTER 

OP 1 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON FULL-WORD BOUNDARY 


OP 2 NOT ON DOUBLE-WORD 
BOUNDARY 


OP 1 NOT EVEN NUMBERED REGISTER 
OP 1 NOT ODD NUMBERED REGISTER 
NONE 


| ssw [so] ors | 4 
Condition Codes 


Cl) tf RESULT = 0, SET TOO 
OF RESULT <0, SET TO1 
Cite RESULT > 0, SET TO 2 
CIF OVERFLOW, SET TO3 
HE UNCHANGED 


OOO O8oO000 





Explicit Format: 








A OPERATION A OPERAND 












1 ,13,d9 (bo) 
4,7,0(2) 


[symbol] 
STORE47 


Implicit Format: 






A OPERATION A OPERAND 






[symbol] 
STORE47 


ry 1382 
4,7,AREATWO 
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SPM 


13.7. SET PROGRAM MASK (SPM) STATUS-SWITCHING INSTRUCTION 


OBJECT |) 7 ADDRESSING C] PROTECTION 





































OPCODE 
pacha wal C] DATA (INVALID SIGN/DIGIT) | (] SIGNIFICANCE 
(eytes) || (] DECIMAL DiviDe C] sPECIFICATION: 










(CJ DECIMAL OVERFLOW 

O execute 

C] EXPONENT OVERFLOW 
(EXPONENT UNDERFLOW 
( FIXED-POINT DIVIDE 

QO FIXED-POINT OVERFLOW 
CD FLOATING-POINT DIVIDE 
C] OPERATION 


NOT A FLOATING-POINT REGISTER 

oP 1 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON FULL-WORD BOUNDARY 


OP 2 NOT ON DOUBLE-WORD 
BOUNDARY 


OP 1 NOT EVEN NUMBERED REGISTER 
OP 1 NOT ODD NUMBERED REGISTER 
NONE 


Condition Codes 


WM iF RESULT = 0,SET TOO 


Mic Resutt <o,setto1 
Wir RESULT >O, SET TO2 
Wir OVERFLOW, SET TO3 
[DI UNCHANGED 


@oo OoOoo00 





The set program mask (SPM) instruction replaces bits 34 through 39 of the current PSW 
with bits 2 through 7 of the operand 1 register. 


Explicit and Implicit Format: 







A OPERATION A OPERAND 


[symbol] 
SETM 


Operational Considerations: 


= §6Bits 0, 1, and 8 through 31 of the operand 1 register are ignored by the OS/3 
hardware. 


= The condition code is set equal to bit positions 2 and 3 of operand 1. 





UP-8061 Rev. 3 SPERRY UNIVAC OS/3 13—16 
ASSEMBLER 








Example: 
LABEL AOPERATIONA OPERAND 
1 10 16 


a ee ee 


LODREG L 3,MASK 
SETM SPM 3 
MASK DC ae 


In this example, | loaded register 3 with the contents of a main storage area called 
MASK. MASK contains a full word of binary 1’s. When the SPM instruction is 
executed, bits 34 through 39 of the PSW are replaced with bits 2 through 7 of 
register 3. 
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svc 


13.8. SUPERVISOR CALL (SVC) STATUS-SWITCHING INSTRUCTION 


OBJECT || - ADDRESSING C] PROTECTION 
OPCODE | FORMAT | INST. 
sa ee Pen CJ DATA (INVALID SIGN/DIGIT) | [) SIGNIFICANCE 
(Bytes) || J DECIMAL DIVIDE C specification: 
O DECIMAL OVERFLOW NOT A FLOATING-POINT REGISTER 
i} EXECUTE OP 1 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON FULL-WORD BOUNDARY 


OP 2 NOT ON DOUBLE-WORD 
BOUNDARY 


OP 1 NOT EVEN NUMBERED REGISTER 
OP 1 NOT ODD NUMBERED REGISTER 


OO EXPONENT OVERFLOW 
Condition Codes C) EXPONENT UNDERFLOW 


Bi settoo CJ FIXED-POINT DIVIDE 
Wsertoi C1 FIxXeD-POINT OVERFLOW 
@ set To2 C] FLOATING-POINT DIVIDE 


fsetTTo3 CD OPERATION 
CO SEE OPER. CONSIDERATIONS 





Boo oooo0 


2 
ie) 
Zz 
m 


The supervisor call (SVC) instruction causes an interrupt and replaces bits 24 through 31 
of the current PSW with the 1-byte contents of operand 1. 


Explicit and Implicit Format: 






A OPERATION A OPERAND 






[symbol] 
SUPCALL 


Operational Considerations: 


ws The operand you specify is an immediate byte of data, which is a 1-byte absolute 
term. 


a Once the SVC instruction is executed, the PSW with its new contents is stored, and a 
new PSW is controlling your program. 


m The condition code is equal to bits 34 and 35 of the PSW after the supervisor call is 
granted. 
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nn 


Example: & 








LABEL AOPERATIONA OPERAND 
] 10 16 
CALL SVC X'OF! 


A supervisor call interrupt is generated, and the value X‘00001111’ is stored in the 
old PSW. 
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TS 


13.9. TEST AND SET (TS) STATUS-SWITCHING INSTRUCTION 


General Possible Program Exceptions 
OBJECT ADDRESSING 
OPCODE FORMAT | INST. a 
TYPE LGTH. 


(J DATA (INVALID SIGN/DIGIT) 
MNEM. (BYTES) 


| mem. | (0 DECIMAL DIVIDE 
OC DECIMAL OVERFLOW 
Psi] s | 4 | 
Condition Codes 


0 execute 
OC ExPONENT OVERFLOW 
0 EXPONENT UNDERFLOW 
FIXED-POINT DIVIDE 
@ set Too Q 
W setto1 0) FIxED-POINT OVERFLOW 
O1 set To2 
OO set To3 
SEE OPER. CONSIDERATIONS 


















@ PROTECTION 

C1 SIGNIFICANCE 

DC SPECIFICATION: 

NOT A FLOATING-POINT REGISTER 
OP 1 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON FULL-WORD BOUNDARY 


OP 2 NOT ON DOUBLE-WORD 
BOUNDARY 


OP 1 NOT EVEN NUMBERED REGISTER 
OP 1 NOT ODD NUMBERED REGISTER 


























CJ FLOATING-POINT DIVIDE 
WB OPERATION 


LOG), Goes 


2 
O° 
Zz 
m 


The test and set (TS) instruction tests the zero bit of the operand 1 main storage area for a 1 
or a O and sets the condition code according to the result. 


NOTE: 


TS is a featured instruction. lf you attempt to issue this instruction to a processor that does 
not have the control feature installed, you cause an operation program exception. 


Explicit Format: 







A OPERATION A OPERAND 


[symbol] 
TEST 


Implicit Format: 






A OPERATION A OPERAND 





[symbol] 
TEST 


52 
STORAGE 
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Operational Considerations: 


= ~§=6©Only the leftmost bit of the operand is tested to determine the condition code setting. 

= All eight bits of the operand byte are set to 1 after the condition code is set. 

= ~The condition code is set as follows: 

— to 0 if the tested bit is 0; or 
— to 1 if the tested bit is 1. 

s = This instruction can be used by two programs referencing the same main storage byte. 
A condition code setting of O indicates that the area is available for use by the testing 
program. A condition code setting of 1 indicates that the area is not available. 

Example: 

LABEL AOPERATION A OPERAND 
1 10 16 

TESTSW TS BYTE 

BYTE DC B'1111 008" 


When the TS instruction is executed, the leftmost bit of BYTE is tested. Since the bit is 
1, the condition code is set to 1. 
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14. Featured Instructions 


This section contains the instructions that are featured. You cannot use a featured 
instruction unless your processor has the control feature. If you attempt to use these 
instructions without the control feature, you cause an operation program exception. 


Within this section, the instructions are grouped alphabetically by instruction category. 
Within each category, they are grouped alphabetically by instruction name. 


The explanation of the checkoff table used for each instruction in this section is included 
in Appendix D. 
14.1. FEATURED BRANCHING INSTRUCTIONS 


The featured branching instructions are described in 14.1.1 and 14.1.2. (See Section 8 for 
descriptions of the remaining branching instructions.) 
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BXH 


14.1.1. Branch on Index High (BXH) 


Possible Program Exceptions 


OBJECT || -] ADDRESSING C] PROTECTION 
Pence tC OrMA| ANS, N T)| DJ SIGNIFICANCE 
ynes Wider: ( DATA (INVALID SIGN/DIGI 
(Bytes) || OD OECIMAL Divide CO SPECIFICATION: 
0 DECIMAL OVERFLOW NOT A FLOATING-POINT REGISTER 
Olexecute — OP 1 NOT ON HALF-WORD BOUNDARY 


OP 2 NOT ON HALF-WORD BOUNDARY 


CO EXPONENT OVERFLOW 
Condition Codes DC EXPONENT UNDERFLOW OP 2 NOT ON FULL-WORD BOUNDARY 
OP 2 NOT ON DOUBLE-WORD 


C0 FIXED-POINT DIVIDE 
OD FIXED-POINT OVERFLOW BOUNDARY 
Cte RESULT > 0, SET TO 2 (1) FLOATING-POINT DIVIDE OP 1 NOT EVEN NUMBERED REGISTER 


CF OVERFLOW, SET TO3 @ OPERATION OP 1 NOT ODD NUMBERED REGISTER 
BB UNCHANGED NONE 


Clif RESULT = 0,SET TOO 
Olir RESULT <0, SET TO1 





The branch on index high (BX) instruction algebraically compares the sum of the operand 
1 register and operand 3 register to either the operand 3 register or one greater than the 
operand 3 register (comparand register). lf the sum is greater than the content of the 
comparand register, a branch to the instruction located at the operand 2 address takes 
place. If a greater than condition does not exist, your program continues processing with 
the instruction following the BXH instruction. The sum is always placed in the operand 1 
register after the comparison. 


Explicit Format: 





A OPERATION A OPERAND 








[symbol] 


Implicit Format: 






A OPERATION A OPERAND 


[symbol] 
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This instruction algebraically adds the content of the operand 1 register to the content of 
the operand 3 register. The sum is algebraically compared to the content of an odd- 
numbered register (which can be the same as the operand 3 register) or a register that is 
one larger than the operand 3 register. If the sum is greater than the content of the odd- 
numbered register it is being compared to, a branch to the instruction located at the 
operand 2 address takes place. If the sum is less than or equal to the content of the odd- 
numbered register it is being compared to, the program continues processing with the 
instruction following the BXH instruction. Following the comparison, the sum is placed in 
operand 1. Usually, the BXH instruction is executed several times (depending on program 
logic) until the content of the operand 1 register is greater than the odd-numbered register 
it is being compared to. Then the branch to the instruction located at the operand 2 
address takes place. 


Operational Considerations: 
= Any of the general registers (0 through 15) can be used as operands 1 and 3. 


u Any odd-numbered register either equal to operand 3 or one greater than operand 3 
can be used as the comparand register. 


a Operand 2 can be any location in main storage. 
= The rules of algebra apply to both the addition and the comparison operations. 


= The condition code remains unchanged. 





Example: 
LABEL AOPERATIONA OPERAND 
1 10 16 
LA 3,4 
LA 4,19 
LA 5,11 
BXH 3,4,LOOP 
AP CARDIN,=P'5@6' 
LOOP cP CARDIN,MAX!MUM 
CARDIN DC PL3'O' 


MAXIMUM DC PL3'19600' 
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Registers 3 and 4 before execution of BXH instruction: 




























1 ' t ‘ 1 
Register 5 (comparand register) before and after execution of BXH instruction: 
1 i 
Registers 3 and 4 after execution of BXH instruction: 
| ' 


In this example, the decimal value 4 is loaded into register 3, the decimal value of 10 is 

loaded into register 4, and the decimal value of 11 is loaded into the comparand register 5. 

When the BXH instruction is executed, the contents of registers 3 and 4 are algebraically 

added together, the sum being decimal value 14 (hexadecimal E). The sum is algebraically 

compared to the content of register 5 and then placed in register 3. Since the sum is @ 
greater than the content of register 5, a branch to the instruction labeled LOOP takes 

place. There, the content of CARDIN is compared to the content of MAXIMUM. 
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BXLE 


14.1.2. Branch on Index Low or Equal (BXLE) 


General Possible Program Exceptions 
OBJECT ADDRESSING OC) PROTECTION 
OPCODE FORMAT | INST. O 
TYPE LGTH. 


[J DATA (INVALID SIGN/DIGIT) C] SIGNIFICANCE 
MNEM. (BYTES) 


| wivem. | (J DECIMAL DIVIDE C) SPECIFICATION: 
OJ DECIMAL OVERFLOW NOT A FLOATING-POINT REGISTER 
[sx [ev] vs | 4 | 
Condition Codes 


OJ Execute OP 1 NOT ON HALF-WORD BOUNDARY 
CO EXPONENT OVERFLOW OP 2 NOT ON HALF-WORD BOUNDARY 
CO EXPONENT UNDERFLOW OP 2 NOT ON FULL-WORD BOUNDARY 
PP SESuL T= Omer nea OD FIXED-POINT DIVIDE OP 2 NOT ON DOUBLE-WORD 
Chie qEaut <0: a4 (CJ FIxXED-POINT OVERFLOW BOUNDARY 
OliF RESULT > 0, SET TO 2 
LJ if OVERFLOW, SET TO 3 
GUNCHANGED 













































(O FLOATING-POINT DIVIDE OP 1 NOT EVEN NUMBERED REGISTER 
OPERATION OP 1 NOT ODD NUMBERED REGISTER 
NONE 


OOO OOOOO0 


The branch on index low or equal (BXLE) instruction algebraically compares the sum of the 
operand 1 register and operand 3 register to either the operand 3 register or one greater 
than the operand 3 register (comparand register). If the sum is less than or equal to the 
content of the comparand register, a branch to the instruction located at the operand 2 
address takes place. If a less than or equal to condition does not exist, the program 
continues processing with the instruction that follows the BXLE instruction. The sum is 
always placed in the operand 1 register after the comparison. 


Explicit Format: 










A OPERATION A 





LABEL OPERAND 


[symbol] r,, 3,4, (b,) 


Implicit Format: 







A OPERATION A OPERAND 


[symbol] 


This instruction algebraically adds the content of the operand 1 register to the content of 
the operand 3 register. The sum is algebraically compared to the content of an odd- 
numbered register, which can be the same as the operand 3 register, or a register that is 
one larger than the operand 3 register. If the sum is less than or equal to the content of 
the odd-numbered register it is being compared to, a branch to the instruction located at 
the operand 2 address takes place. If the sum is greater than the content of the odd- 
numbered register it is being compared to, the program continues processing with the 
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instruction following the BXLE instruction. Following the comparison, the sum is placed in 
operand 1. Usually, the BXLE instruction is executed several times (depending on program 
logic) until the content of the operand 1 register is less than or equal to the odd-numbered 
register to which it is being compared. Then the branch to the instruction located at the 
operand 2 address takes place. 


Operational Considerations: 
= Any of the general registers (0 through 15) can be used as operands 1 and 3. 


= Any odd-numbered register either equal to operand 3 or one greater than operand 3 
can be used as the comparand register. 


= Operand 2 can be any location in main storage. 
= The rules of algebra apply to both the addition and the comparison operations. 


= =§=The condition code remains unchanged. 





Example: 
LABEL AOPERATIONA OPERAND 
] 10 16 
L 4 ,VALUEI 
L 5, VALUE2 
BXLE 4,5, BRANCHTO 
NEXTSEQ AP A,B 
BRANCHTO CP A,B 
VALUE] DC F'-3!' 
VALUE2 DC F'lg' 
A DC PL4'296' 
B DC PL2'16! 


In this example, the values —3 and +10 are loaded into registers 4 and 5, 
respectively. The BXLE instruction compares the sum of the content of registers 4 and 
5 (+7) to the content of the comparand register, register 5. Since +7 is less than 10, 
the branch is taken. The next instruction executed (CP) is located at BRANCHTO. 


14.2. FEATURED FIXED-POINT INSTRUCTIONS 


The featured fixed-point instructions are described in 14.2.1 through 14.2.10. (See Section 
10 for descriptions of the remaining fixed-point instructions.) 
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DR 


14.2.1. Divide (DR) 
















OPCODE OBJECT || [1] ADDRESSING C] PROTECTION 
geal oe (J DATA (INVALID SIGN/DIGIT)| [] SIGNIFICANCE 
sulbaadh (eyes) || O DECIMAL DIVIDE @ SPECIFICATION: 


OJ DECIMAL OVERFLOW 
0 EXECUTE 


NOT A FLOATING-POINT REGISTER 

OP 1 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON FULL-WORD BOUNDARY 


OP 2 NOT ON DOUBLE-WORD 
BOUNDARY 


OP 1 NOT EVEN NUMBERED REGISTER 
OP 1 NOT ODD NUMBERED REGISTER 
NONE 


Condition Codes 


CJ iF RESULT =0,SET TOO 


CJ EXPONENT OVERFLOW 
C0 EXPONENT UNDERFLOW 
Wi FIXED-POINT DIVIDE 

C1 FIxXED-POINT OVERFLOW 
OJ FLOATING-POINT DIVIDE 
B® OPERATION 


Cire RESULT <0, SET TO1 
OF RESULT > 0, SET TO 2 
(IF OVERFLOW, SET TO 3 
BB UNCHANGED 





OOm@ OOO0OO 





The DIVIDE (DR) instruction algebraically divides the contents of the double word in the 
operand 1 register pair (dividend) by the full word in the operand 2 register. The result 
(quotient and remainder) is placed in operand 1. 


Explicit and Implicit Format: 






A OPERATION A OPERAND 


[symbol] 


Operational Considerations: 


= Operand 1 consists of a pair of contiguous registers (64 bits) containing a fixed-point 
binary value. The registers are even-odd numbered, the lower numbered register 
being even. You must specify the even-numbered register as operand 1. The odd- 
numbered registers must contain the dividend before you can use this instruction. 
You may specify any of the general registers (O through 15). 


= Operand 2 is a 32-bit register (O through 15) containing a fixed-point binary value 
(dividend). Operand 2 is not changed by the execution of this instruction. 


= After the instruction is executed, the quotient with sign is put into the odd-numbered 
register, and the remainder with the same sign occupies the even-numbered register. 
If the quotient and remainder do not fill their respective 32-bit fields, leftmost bit 
positions are filled by bits having the same value as the sign. 
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= If you attempt to divide by zero, or if the quotient does not fit into the 32-bit odd- @ 
numbered register in operand 1, a fixed-point divide program exception occurs. 


= The DR instruction is a featured instruction. An operation program exception is 
caused if you use this instruction and your processor does not have the control 





feature. 
Example: 
LABEL AOPERATIONA OPERAND 
1 10 16 
LM 6,8,DIVEND 
DR 6,8 
DIVEND DC D'+64! 
DIVISOR oC F '+32! 


in this example, registers 6, 7, and 8 are loaded with the main storage contents of 
DIVEND and DIVISOR, respectively. Then, divide the contents of registers 6 and 7 by 
the contents of register 8 and placed the result (quotient with sign) in register 7. 





Note that the use of the LM instruction eliminates the writing of three separate load 
instructions but still loads three registers. Also note that the quotient and its sign are 
loaded into register 7 and and the remainder with the same sign value as the 
quotient that occupies register 6. 


Registers 6 and 7 before execution of DR instruction: 


0000 0000 0000, 0000 npg one COCO eee 0000; 0000 } 0000 9000 pope, BoeS 0100; 0000 






















binary 
Register 8 before and after execution of DR instruction: 
0000 , 0000} 0000, 0000] 0000 0000} 0010| 0000 bivary 
Registers 6 and 7 after execution of DR instruction: 
s i 


i) 1 
t 
012 





hex & 
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LCR 


14.2.2. Load Complement (LCR) 


a a 
OPCODE FORMAT | INST. 
TYPE LGTH. 


Possible Program Exceptions 


(7 ADDRESSING (1 PROTECTION 

C) DATA (INVALID SIGN/DIGIT) C0 SIGNIFICANCE 

(J DECIMAL DIVIDE C) SPECIFICATION: 

OD DECIMAL OVERFLOW NOT A FLOATING-POINT REGISTER 

OO Execute OP 1 NOT ON HALF-WORD BOUNDARY 
(J ExPONENT OVERFLOW OP 2 NOT ON HALF-WORD BOUNDARY 
(0 EXPONENT UNDERFLOW OP 2 NOT ON FULL-WORD BOUNDARY 
(0 FIXED-POINT DIVIDE OP 2 NOT ON DOUBLE-WORD 


@ FIXED-POINT OVERFLOW BOUNDARY 
C0 FLOATING-POINT DIVIDE OP 1 NOT EVEN NUMBERED REGISTER 


Wl OPERATION OP 1 NOT ODD NUMBERED REGISTER 
NONE 


(BYTES) 
poce[rs[ mm [2 _| 


Condition Codes 


@ iF RESULT =0,SET TOO 
Wir RESULT <o, SET TO1 
Mf RESULT >0O, SET TO 2 
Hi iF OVERFLOW, SET TO 3 
(I UNCHANGED 









o 
O 
O 
Oo 
O 
O 
O 
0 





The /oad complement (LCR) instruction places the twos complement form of the contents 
of operand 2 register into the operand 1 register. 


Explicit and Implicit Format: 






AOPERATION A OPERAND 


[symbol] 


Operational Considerations: 
= Any of the general registers (0 through 15) can be used as operands 1 and 2. 


= §6|f operand 2 is a positive value, the twos complement of that value is placed into 
operand 1 when the instruction is executed. If the value in operand 2 is negative, the 
positive value is placed in operand 1 when the instruction is executed. The maximum 
value you can specify in operand 2 is +2,147,483,647 (23'-1) or -2,147,483,647 
(-23'— 1). 


= A zero value in operand 2 is not changed when complemented. 
= Operand 2 is not changed by the execution of the instruction. 


a The LCR instruction is a featured instruction. An operation program exception is caused 
if you use this instruction and your processor does not have the control feature. 
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Example: 
LABEL AOPERATIONA OPERAND 
] 10 16 
L 5,FULLWORD 
LCR 6,5 
LTR 6,6 
FULLWORD DC F'1gp' 


Register 5 before and after execution of LCR instruction: 


0000 0000 0000} 0000} 0000] 0000/011040100 


Register 6 after execution of LCR instruction: 


In this example, the contents of FULLWORD is loaded into register 5 and the LCR 
instruction loads the complement of the content of register 5 into register 6. Since the 
result is less than zero, the condition code is set to 1 and the load and test (LTR) 
instruction (see 10.14) loads the content of register 6 into itself and tests the condition 
code. Because the registers of operands 1 and 2 in the LTR instruction are the same, 
the operation is performed as a test without data movement. 






binary 





hex 



















binary 





hex 
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LNR 


14.2.3. Load Negative (LNR) 


Possible Program Exceptions 








OBJECT 


OPCODE FORMAT | INST. 
LGTH. 


TYPE 
Fua{u{ re [ 2 | 


Condition Codes 


MiF RESULT =0,SET TOO 
Wir RESULT <0, SET TO1 
CJiF RESULT > 0, SET TO 2 







(J ADDRESSING C1) PROTECTION 

(] DATA (INVALID SIGN/DIGIT) | [) SIGNIFICANCE 
C] DECIMAL DIVIDE DC SPECIFICATION: 
OO DECIMAL OVERFLOW 
OD ExecuUTE 






NOT A FLOATING-POINT REGISTER 

OP 1 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON FULL-WORD BOUNDARY 


OP 2 NOT ON DOUBLE-WORD 
BOUNDARY 


OP 1 NOT EVEN NUMBERED REGISTER 
OP 1 NOT ODD NUMBERED REGISTER 
NONE 






CJ EXPONENT OVERFLOW 
(2 EXPONENT UNDERFLOW 
C) FIXED-POINT DIVIDE 

0 FIxXED-POINT OVERFLOW 
CO FLOATING-POINT DIVIDE 
OPERATION 


CJiF OVERFLOW, SET TO 3 
[CJ UNCHANGED 


OOO OOOOO0O 





The /oad negative (LNR) instruction places the twos complement of the content of the 
operand 2 register into the operand 1 register. If operand 2 contains a negative value or a 
value of zero, the instruction places that value unchanged into operand 1. 


Explicit and Implicit Format: 







A OPERATION A OPERAND 


[symbol] 


Operational Considerations: 
= Any of the general registers (0 through 15) can be used as operands 1 and 2. 
= The LNR instruction is a featured instruction. An operation program exception is 


caused if you use this instruction and your processor does not have the control 
feature. 
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a  — 


Example: 
LABEL AOPERAT IONA OPERAND 
1 10 16 
LM 5,7,NUMBERS 1 
LNR 555 
LNR 6,6 
LNR 7,7 
NUMBERS] DC F'y! 
NUMBERS2 DC F's! 
NUMBERS3 DC F'6! 


In this example registers 5, 6, and 7 are filled with contents of NUMBERS1, 
NUMBERS2, and NUMBERS3, respectively. Then the series of three LNR instructions 
place the twos complement form of the three full words in registers 5, 6, and 7 back 
into themselves. 


Register 5 before execution of the LNR instruction: 


0000 0000] 0000; 0000 0000 ; 0000/0000 }0100 


Register 6 before execution of LNR instruction: 


0000, 0000] 0000; 0000 0000; 0000 000010101 


Register 7 before execution of LNR instruction: 


0000 0000| 0000; 0000 0000] 0000! 0000 ;0110 











binary 


hex 









binary 


hex 











binary 


hex 














UP-8061 Rev. 3 SPERRY UNIVAC 0S/3 14-13 


































ASSEMBLER 
& Register 5 after execution of LNR instruction: 
I 
Register 6 after execution of LNR instruction: 
Register 7 after execution of LNR instruction: 
feespeenforepeoe] say 
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14.2.4. Load Positive (LPR) 


Possible Program Exceptions 


[] ADDRESSING C] PROTECTION 

[LJ DATA (INVALID SIGN/DIGIT) (LJ SIGNIFICANCE 

(1) DECIMAL Div!IDE CJ SPECIFICATION: 

CJ DECIMAL OVERFLOW NOT A FLOATING-POINT REGISTER 

O Execute OP 1 NOT ON HALF-WORD BOUNDARY 
(] EXPONENT OVERFLOW OP 2 NOT ON HALF-WORD BOUNDARY 
(1) EXPONENT UNDERFLOW OP 2 NOT ON FULL-WORD BOUNDARY 
C] FIXED-POINT DIVIDE OP 2 NOT ON DOUBLE-WORD 


@ FIxED-POINT OVERFLOW BOUNDARY 
C] FLOATING-POINT DIVIDE OP 1 NOT EVEN NUMBERED REGISTER 


BB OPERATION OP 1 NOT ODD NUMBERED REGISTER 
NONE 












OBJECT 
OPCODE FORMAT | INST. 











TYPE LGTH. 


Condition Codes 


Wir RESULT =0,SET TOO 
OiF RESULT <o, SET TO1 
Wir RESULT >0o, SET TO2 
GiF OVERFLOW, SET TO3 
CU UNCHANGED 




















DWE Bebe 









The /oad positive (LPR) instruction places the positive value of the content of the operand 2 
register in the operand 1 register. If operand 2 contains a positive value or zero, that same 
value is placed unchanged in operand 1. If operand 2 contains a negative number, the 
twos complement of that number (its positive value) is loaded into operand 1. 


Explicit and Implicit Format: 





A OPERATION A OPERAND 






[symbol] 






Operational Considerations: 
= Any of the general registers (O through 15) can be used as operand 1 and 2. 


= The maximum negative value you can specify in operand 2 is —2,147,483,657 
(—23'—1). Otherwise, a fixed-point overflow program exception occurs. 


= = Operand 2 is not changed by the execution of the instruction. 
a The LPR instruction is a featured instruction. An operation program exception is 


caused if you use this instruction and your processor does not have the control 
feature. 
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& Example: 

LABEL AOPERATIONA OPERAND 
| 10 16 

LM 5,7,NUMBERSI 

LPR 5,5 

LPR 6,6 

LPR 77 
NUMBERS! DC Filed! 
NUMBERS2 DC Fins! 
NUMBERS3 DC Fln6! 


In this example, registers 5, 6, and 7 are filled with the contents of NUMBERS1, 
NUMBERS2, and NUMBERS3, respectively. Then the series of three LPR instructions 
place the twos complement form of the three full words in registers 5, 6, and 7 back 
into themselves. The result is their positive values. 


Register 5 before execution of LPR instruction: 





Register 6 before execution of LPR instruction: 


binary 


hex 











Register 7 before execution of LPR instruction: 


binary 


hex 
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Register 5 after execution of LPR instruction: 


























0000 } 0000 | 0000| 0000] 0000; 0000} 0000; 0100 binary 
Register 6 after execution of LPR instruction: 

0000 ;0000| 00001 0000 ope! 0000} 0000) 0101 binary 
Register 7 after execution of LPR instruction: 

0000 | 0000/ 0000; 0000] 0000; 0000 0000! 0110 binary 
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MR 


14.2.5. Multiply (MR) 


Possible Program Exceptions 
OPCODE ___"_ (J ADDRESSING Fl pROTEeTION 
FORMAT | INST. 
GNIFICANCE 
TYPE ane: (] DATA (INVALID SIGN/OIGIT)| 1 st c 


(Bytes) || ) DECIMAL DIVIDE Wl SPECIFICATION: 

NOT A FLOATING-POINT REGISTER 
OP 1 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON FULL-WORD BOUNDARY 


OP 2 NOT ON DOUBLE-WORD 
BOUNDARY 


OP 1 NOT EVEN NUMBERED REGISTER 
OP 1 NOT OOD NUMBERED REGISTER 
NONE 


CJ DECIMAL OVERFLOW 
OO execute 


OJ EXPONENT OVERFLOW 
Condition Codes OO EXPONENT UNDERFLOW 


PIISRESULT = OSL TO OO FIXED-POINT DIVIDE 
Or RESULT <o SET TO 0 FIxXED-POINT OVERFLOW 


Cte RESULT > 0, SET TO 2 ( FLOATING-POINT DIVIDE 
CIF OVERFLOW, SET TO 3 @@ OPERATION 
GB UNCHANGED 


DO@ OOOOO 





The multiply (MR) instruction algebraically multiplies the content of the operand 1 register 
pair (multiplicand) by the content of the operand 2 register (multiplier). The result (product) 
is placed in operand 1. 


Explicit and implicit Format: 








A OPERATION A OPERAND 


[symbol] 


Operational Considerations: 


= Operand 1 consists of a pair of even-odd registers (64 bits). You must specify the 
even-numbered register as operand 1, and you must load the odd-numbered operand 
1 register with the multiplicand before using this instruction. 


= The product fills the odd-numbered register first and then, if necessary, the even- 
numbered register. 


= Any of the general registers (0 through 15) can be used as operands 1 and 2. 
Operand 2 is not changed by the execution of this instruction. 


s The MR instruction is a featured instruction. An operation program exception is 
caused if you use this instruction and your processor does not have the control 
feature. 
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Example: 

LABEL § AOPERATIONA OPE RAND 
1 10 16 

LH 8,PRICE 

LH 7 ,NEWBUY 

MR 6,8 
NEWBUY DC H'73' 
PRICE DC H'1g! 


In this example, place the contents NEWBUY and PRICE into registers 7 and 8, 
respectively. Then, multiply the content of the even-odd register-pair 6 and 7 by 
register 8. (You address the pair of registers by using register 6.) The result is placed 
in register 7. If, however, the result of the multiplication exceeds the capacity of 
register 7, register 6 is filled with the remainder of the result. 


Registers 6 and 7 before execution: 






binary 


00001 0000 j 0000] 0000} 0000 | 0000] 0000] C000 ff 0000 | 0000 | 0000 | 0000 | 0000; 0000} 0100; 1001 


doubie word 





hex 


Register 8 before execution: 













0000] 0000 0000 | 0000 0000 | 000 | 0000 | 0000 § 0000 | 0000 | 0000 | 0000 | 0000 | 0010 101 11010 


double word 


binary 


hex 
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MH 


14.2.6. Multiply Half Word (MH) 


General Possible Program Exceptions 
OBJECT 
OPCODE FORMAT | INST. 
TYPE LGTH. 
Condition Codes : 


Clif RESULT = 0, SET TOO 
Clie RESULT <0,SETTO1 
Ole RESULT >0, SET TO 2 
OF OVERFLOW, SET TO 3 
HBEUNCHANGED 










Mi ADDRESSING WPROTECTION 

(J DATA (INVALID SIGN/DIGIT) | [) SIGNIFICANCE 

C] DECIMAL DiviDE @ sSPeciIFICATION: 

(J DECIMAL OVERFLOW NOT A FLOATING-POINT REGISTER 
(0 Execute OP 1 NOT ON HALF-WORD BOUNDARY 













(CJ EXPONENT OVERFLOW OP 2 NOT ON HALF-WORD BOUNDARY 
( EXPONENT UNDERFLOW OP 2 NOT ON FULL-WORD BOUNDARY 
C] FIXED-POINT DIVIDE OP 2 NOT ON DOUBLE-WORD 


OC FIXED-POINT OVERFLOW BOUNDARY 
C] FLOATING-POINT DIVIDE OP 1 NOT EVEN NUMBERED REGISTER 


@ OPERATION OP 1 NOT ODD NUMBERED REGISTER 
NONE 





The multiply half word (MH) instruction algebraically multiplies the content of the operand 
1 register by the half word operand 2. The result is placed in the operand 1 register. 


Explicit Format: 







A OPERATION A OPERAND 


[symbol] 


Implicit Format: 


LABEL A OPERATION A OPERAND 


[symbol] 41 Sy (X4) 
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Operational Considerations: 

ms Any of the general registers (0 through 15) can be used as operand 1. 

= Before execution of the MH instruction, operand 2 is expanded from 16 to 32 bits. 
The 16 high order bits are propagated with the sign bit value. The contents of 
operand 2 before the 16-high order bits are propagated with the sign bit value. 


sign bit 






0000 | 0000} 0000 | 1010 binary 
ola hex 
half word 


The contents of operand 2 after the 16 high order bits are propagated with the sign 
bit value. 


sign bit 


0000 | 0000 |0000 | 0000 | 0000 | 0000 } 0000 | 1010 


ae We ae) Ores 
|________| 


sign bits 


b___________ 


full word 





binary 


hex 





Operand 2 is not permanently changed by the execution of the instruction. 


= ~=6The result (product) fills the 32-bit operand 1 register from right to left. If the product 
does not fit into the operand 1 field, extra leftmost bits are truncated and the result or 
sign may be incorrect. 


= = =The MH instruction is a featured instruction. An operation program exception is 
caused if you use this instruction and your processor does not have the control 
feature. 
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Example: 

LABEL AOPERATIONA OPERAND 
1 10 16 

L 7 ,NEWBUY 

MH 7,PRICE 
NEWBUY DC eae 
PRICE DC H'1p' 


In this example, load the contents NEWBUY into register 7 and multiply the halfword 
of PRICE by the content of register 7. The product is placed in register 7. 


Register 7 before execution of MH instruction: 


0000| 0000 | 0000 | 0000) 0000] 0000/0100 |1001 


PRICE before and after execution of MH instruction: 







binary 


hex 








sign bit 


0000] 0000 | 0000 | 0000 | 0000 | 0000 | 0000 1010 


sign bit value 
propagated through 
16-high order bit 
positions 






binary 


hex 





Register 7 after execution of MH instruction: 


0000 | 0000 | 0000 | 0000 c000[ 010|1101] 1010 | 





binary 





hex 
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14.2.7. Shift Left Double (SLDA) 


Possible Program Exceptions 


(J ADDRESSING (C PROTECTION 

















OBJECT 























OPCODE % 
peviveas rp CJ DATA (INVALID SIGN/DIGIT) | [J SIGNIFICANCE 
ae (Bytes) || (] DECIMAL DIVIDE W@ SPECIFICATION: 










DC DECIMAL OVERFLOW 

C] Execute 

D0 EXPONENT OVERFLOW 
(1 EXPONENT UNDERFLOW 
O FIXED-POINT DIVIDE 

@ FIxXED-POINT OVERFLOW 
OC FLOATING-POINT DIVIDE 
HE OPERATION 


NOT A FLOATING-POINT REGISTER 

OP 1 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON FULL-WORD BOUNDARY 


OP 2 NOT ON DOUBLE-WORD 
BOUNDARY 


OP 1 NOT EVEN NUMBERED REGISTER 
OP 1 NOT ODD NUMBERED REGISTER 


supa [ar | rs | 4 | 
Condition Codes 


M@ iF RESULT = 0,SETTOO 
@ ir Resuct <o,seTTo1 
Wir RESULT >0, SET TO 2 
@ iF OVERFLOW, SET TO 3 
OI UNCHANGED 


OOg OOooOo0 


2 
oO 
z 
m 


The shift left double (SLDA) instruction shifts all of the 63 bits of the operand 1 even-odd 
register pair to the left the number of bits specified by the low order six bits of the operand 
2 address. 


Explicit Format: 







A OPERATION A OPERAND 


[symbol] 


Implicit Format: 










A OPERATION A OPERAND 


[symbol] 


Operational Considerations: 


a Any pair of general registers (O through 15) can be used as operand 1. Operand 1 is 
an even-odd-numbered register pair. You must specify the even-numbered register of 
the pair as operand 1. 


a The main storage address or label you specify in operand 2 is not changed by the 
SLDA instruction execution. Notice the formats indicate that you cannot specify a 
length in operand 2. 
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= @=The sign bit (leftmost bit) of the even-numbered operand 1 register pair is not moved 
or changed by the execution of this instruction. Only the 63 remaining bits can be 
shifted by this instruction. 


= After the requested number of bits are shifted out of the operand 1 register pair, 
zeros fill the rightmost bit positions of the register pair that were emptied. 


= §©During the instruction execution, each bit being shifted out is checked when it is the 
bit adjacent to the sign bit. If the bit differs from the sign, it cannot be shifted out 
without causing a fixed-point overflow program exception. 


Before shifting two bits left: 


sign bit 
third bit to be shifted 


o!001! 0101 0010} 00001111] 0101 | 001 jo001 11110000] 0000! 1010] 1010}0001 | 1000; 0001 







After shifting two bits left: 


| 
1000; 0011 +101}0110[0100}0111 1100; 0000} 0010! 1010] 1000 0110/0000; 0100 


Shifting left three bits in this register pair causes a fixed-point overflow program 
exception, since the third bit being shifted is not the same value as the sign bit. In 
this example, two bits are successfully shifted out, but when the third bit is moved 
adjacent to the sign bit and tested, it is not like the sign. 





0/101! 0100 


” Each time you shift one digit left, it is the same as multiplying by a power of 2. If you 
shift one bit left, you multiply by 2, two bits left, you multiply by 22, three bits by 23, 
and so forth. 


= When the shift value is zero, it causes a double-length sign and magnitude test, and 
the condition code is set. 


= The SLDA instruction is a featured instruction. An operation program exception is 
caused if you use this instruction and your processor does not have the control 
feature. 





UP-8061 Rev. 3 , SPERRY UNIVAC OS/3 14—24 








ASSEMBLER 
Example: 
LABEL AOPERAT IONA OPERAND 
] 10 16 
L 9, FULLWORD 
SLDA 8,4 
FULLWORD DC F'hok3! 


In this example, registers 8 and 9 are shifted four bit positions left. Before the SLDA 
instruction, the content of FULLWORD is placed into register 9. Operand 2 is 
expressed in explicit format with 4 as the displacement (d,) and no base register (b.) 
representation. Consequently, the addition of base register and displacement values is 
not performed by the assembler and the operand 2 displacement value becomes the 
absolute value. 


Before execution of SLDA instruction: 


Register 8 Register 9 


8) :000! 0000 0000} 0000 0000} 0000 0000} 0000 0000} 0000 0000; 0000 0001! , 0001 Hott}anit 


[LLL LLL 1 La 


010000000) 2000000 0000; 0000 0000} 0000 0000} 0000 0000/0001 0001} 1011 1111;0000 


Note that the content of register 9 before the shift is 4543, and after shifting four bits 
left, it contains 72,688 (4543 multiplied by 24(16)). 










lost 
bits 





zero 
filled 


After SLDA instruction execution: 
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14.2.8. Shift Left Single (SLA) 


Possible Program Exceptions 












OBJECT 
ADDRESSING CJ PROTECTION 
OPCODE | FORMAT | INST. 0 
Tee cert. [1 DATA (INVALID siGn/pIGiT)| 1 SIGNIFICANCE 
(BYTES) || D) OECIMAL DIVIDE CD sPECIFICATION: 
OJ DECIMAL OVERFLOW 
C0 Execute 





NOT A FLOATING-POINT REGISTER 

OP 1 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON FULL-WORD BOUNDARY 


OP 2 NOT ON DOUBLE-WORD 
BOUNDARY 


OP 1 NOT EVEN NUMBERED REGISTER 
OP 1 NOT ODD NUMBERED REGISTER 
NONE 


jsua_| ss] as | 4 | 
Condition Codes 


Wir RESULT =0,SET TOO 
Wir resuct <o,setto1 
@ if RESULT > 0, SET TO 2 
Gif OVERFLOw, SET TO 3 
(J UNCHANGED 







(J EXPONENT OVERFLOW 
0 EXPONENT UNDERFLOW 
OC FIxX€D-POINT DIVIDE 

@ FixeD-POINT OVERFLOW 
CO FLOATING-POINT DIVIDE 
OPERATION 


OOO OOOOO 





The shift left single (SLA) instruction shifts the 31 bits of the operand 1 register to the left 
of the number of bits specified by the low order six bits of the operand 2 address. The sign 
bit (the leftmost high order bit) of register 1 remains unchanged, and zeros fill the vacated 
positions of the register. 


Explicit Format: 







A OPERATION A OPERAND 


[symbol] 


Implicit Format: 


LABEL A OPERATION A OPERAND 


[symbol] 
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Operational Considerations: 


Any of the general registers (0 through 15) can be used as operand 1. 


The main storage address or label you specify in operand 2 is not changed by the SLA 
instruction execution. Notice the formats indicate that you cannot specify a length in 
operand 2. 


The sign bit (leftmost bit) of the operand 1 register is not shifted or changed by the 
execution of this instruction. Only the 31 remaining bits can be shifted by the 
execution of this instruction. 


After the requested number of bits are shifted out of the operand 1 register, zeros fill 
the vacated rightmost bit positions. 


During the instruction execution, each bit being shifted out is checked when it is the 
bit adjacent to the sign bit. If the bit differs from the sign, it cannot be shifted out 
without causing a fixed-point overflow program exception. 


Before shifting two bits left: 


sign bit 
third bit to be shifted 


// 


After shifting two bits left: 


Shifting left three bits in this register causes a fixed-point overflow program 
exception, since the third bit being shifted is not the same value as the sign bit. In 
this example, two bits are successfully shifted out, but when the third bit is moved 
adjacent to the sign bit and tested, it is not like the sign. 





lost 
bits 










zero 
filled 





For numbers with a value of less than 239(1,073,741,824), each time you shift one 
digit left, it is the same as multiplying by a power of 2. If you shift one bit left, you 
multiply by 2'; two bits left, you multiply by 22; three bits by 23; and so forth. 


The SLA instruction is a featured instruction. An operation exception is caused if you 
use this instruction and your processor does not have the control feature. 
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@ Example: 
LABEL AOPERATIONA OPERAND 
1 10 16 
L 8, FULLWORD 
SLA 8,1 
FULLWORD DC F'4SH3! 


In this example, the content of main storage location FULLWORD is placed in register 
8. Register 8 is then shifted one bit position left. . 


Register 8 before execution of SLA instruction: 


0} 000! 0000] 00000000} 0001 | 0001] 101141111 






After SLA instruction execution: 


0}000}0000| 0000/0000] 0010 0011]0111| 1110 


Note that register 8 contains 4543 before the SLA instruction and 9086 afterwards. 
By shifting one bit left, the content of register 8 is multiplied by 2. 
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SRDA 


14.2.9. Shift Right Double (SRDA) 


Possible Program Exceptions 
OPCODE | FORMAT 
TYPE 
: | mem. | HEX. | 


( ADDRESSING (1 PROTECTION 
Condition Codes 


Mir RESULT = 0, SET TOO 
Wir RESULT <0, SET TO1 
Mie RESULT >0, SET TO 2 
CF OVERFLOW, SET TO3 
CU UNCHANGED 





















OBJECT 
















ee (0 DATA (INVALID SIGN/DIGIT) | [] SIGNIFICANCE 
(Bytes) || (] DECIMAL DIVIDE Hl SPECIFICATION: 















CD DECIMAL OVERFLOW 

C1 ExecuTE 

CC] EXPONENT OVERFLOW 
FC EXPONENT UNDERFLOW 
OJ FIXED-POINT DIVIDE 

D FIxED-POINT OVERFLOW 
C FLOATING-POINT DIVIDE 
HB OPERATION 


NOT A FLOATING-POINT REGISTER 

OP 1 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON FULL-WORD BOUNDARY 


OP 2 NOT ON DOUBLE-WORD 
BOUNDARY 


OP 1 NOT EVEN NUMBERED REGISTER 
OP 1 NOT ODD NUMBERED REGISTER 
NONE 


OOg® OOOOO 


The shift right double (SRDA) instruction shifts the 63 bits of operand 1 to the right the 
number of bits specified by the low order six bits of the operand 2 address. You cannot 
shift the sign bit. Specify the even-numbered register of the pair as operand 1. 


Explicit Format: 








A OPERATION A OPERAND 


[symbol] 


Implicit Format: 










A OPERATION A OPERAND 


[symbol] 
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Operational Considerations: 


Any pair of general registers (0 through 15) can be used as operand 1, which is an 
even-numbered register pair. You must specify the even-numbered register of the pair 
as operand 1. 


The main storage address or label you specify in operand 2 is not changed by the 
SRDA instruction execution. Notice the formats indicate that you cannot specify a 
length in operand 2. 


The sign bit (leftmost bit) of the even-numbered operand 1 register pair is not moved 
or changed by the execution of this instruction. Only the 63 remaining bits can be 
shifted by this instruction. 


After the requested number of bits are shifted-out of the operand 1 register pair, the 
vacated leftmost bit positions are filled with bits that have the same value as the sign 
bit. 


For positive values, each time you shift one bit position right, it is the same as 
dividing by a power of 2. If you shift one bit right, you divide by 2'; two bits right, you 
divide by 22; three bits by 23; and so forth. When the value is negative, shifting right 
causes a divide by 2 on a value one less than the value in the register. For examples, 
see SRA instruction. 


When the shift value is zero, it causes a double-length sign and magnitude test, and 
the condition code is set. 


The SRDA instruction is a featured instruction. An operation program exception is 
caused if you use this instruction and your processor does not have the control 
feature. 


Example: 


LABEL AOPERAT 10NA OPERAND 
1 10 16 


Ap SC CIP SE PT a I ST 


L 9 , FULLWORD 
SRDA 8,4 


FULLWORD DC F'72688' 
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In this example, registers 8 and 9 are shifted four bit positions right. Before the SRDA & 
instruction, the contents of FULLWORD are placed into register 9. 


Before SRDA instruction execution: 


0; jooo} 0000 0000 }0000 oo00! 2000 | 2000 | 0000 0000] 0000; 0000 0000! 0001 0001} 1011}1111 | 0000 


After SRDA instruction execution: 


o!o00! 0000 1000/0000 0000} 0000 0000 }o000 0000 10000 0000} 0000 00010001 1011,1111 


Notice that the contents of register 9 before the shift are 72,688, and after shifting 
four bits right, it contains 4543 (72,688 divided by 24(16)). 
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@ SRA 


14.2.10. Shift Right Single (SRA) 


Possible Program Exceptions 


OBJECT || () ADDRESSING C1 PROTECTION 


OPCODE FORMAT | INST 
d F 
evee var: (J DATA (INVALID SIGN/DIGIT)| [) SIGNIFICANCE 


(syTes) || (J DECIMAL DIVIDE C0 SPECIFICATION: 
0 DECIMAL OVERFLOW 
O execute 


NOT A FLOATING-POINT REGISTER 

OP 1 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON FULL-WORD BOUNDARY 


OP 2 NOT ON DOUBLE-WORD 
BOUNDARY 


OP 1 NOT EVEN NUMBERED REGISTER 
OP 1 NOT ODD NUMBERED REGISTER 
NONE 


(1 EXPONENT OVERFLOW 
Condition Codes C1 ExPONENT UNDERFLOW 
DD FIXED-POINT DIVIDE 
Wir RESULT =0,SETTOO 
Wir REsuLt <0, SETTO1 C2 FIxED-POINT OVERFLOW 
Wir RESULT >0, SET TO2 (0 FLOATING-POINT DIVIDE 


CF OVERFLOW, SET TO 3 BB OPERATION 
(CJ) UNCHANGED 


OOO OOOOO 





The shift right single (SRA) instruction shifts the 31 bits of the operand 1 register to the 
right the number of bits specified by the low order six bits of the operand 2 address. You 
cannot shift the sign bit. 


@ Explicit Format: 








OPERAND 






A OPERATION A 


[symbol] 





Implicit Format: 


LABEL A OPERATION A OPERAND 





[symbol] SRA tess 
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Operational Considerations: 





= Any of the general registers (0 through 15) can be used as operand 1. 


= The main storage address or label you specify in operand 2 is not changed by the 
SRA instruction execution. Notice the formats indicate that you cannot specify a 
length in operand 2. 


= The sign bit (leftmost bit) of the operand 1 register is not shifted or changed by the 
execution of this instruction. Only the 31 remaining bits can be shifted by the 
execution of this instruction. 


= After the requested number of bits are shifted out of the operand 1 register, the 
vacated leftmost bits are filled with bits that have the same value as the sign bit. 


a If the contents of the operand 1 register are a positive value, shifting right one bit 
divides the value of the register by 2. Any remainders are rounded downward. For 
example, a value of +5 shifted right one bit produces a +2 in the register after the 
shift. 


Before one bit shift right: 


0!000;0000] 0000! 0000] 0000} 0000] 0000! 0101 












After one bit shift right: 


0}000!0000} 0000; 0000} 0000! 0000} 0000! 0010 


When contents of the operand 1 register are negative, shifting right one bit causes a 
divide by 2 on a value one less than the value in the operand 1 register. For example, 
a value of —5, when shifted right one bit produces a —3 in the register (—6 divided 
by 2). 





Before one bit shift right: 


ataaa}4411 avian frais] 1111/1011 









After one bit shift right: 


| 
UE FE AT A 
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Note that a negative is expressed in twos complement notation. After the shifting 


operation, you can determine the positive value in the register by taking the twos 
complement of a negative number. 


tatttagy ivttiint 111111111]1111/1101] — -3 (twos complement of +3) 


1111114100 


0} 000!0000} 0000; 0000} 0000! 0000} 0000/0011 


+3 (twos complement of -3) 


= The SRA instruction is a featured instruction. An operation program exception is 
caused if you use this instruction and your processor does not have the control 
feature. 

Example: 
LABEL AOPERAT IONA OPERAND 
1 10 16 
@ L 8, FULLWORD 
SRA 8,1 

FULLWORD DC F'hS43! 


in this example, the content of main storage location FULLWORD is placed in register 
8. Register 8 is then shifted one bit position right. 


Register 8 before SRA instruction execution: 






0/000 {0000 |0000!0000} 0001 } 0001 







Register 8 after SRA instruction execution: 


0}000}0000| 0000 }0000 0000} 1000 ror} any 


Note that register 8 contains 4543 before the SRA instruction and 2271 afterwards. 
By shifting one bit right, the content of register 8 is divided by 2. 


& 14.3. FEATURED LOGICAL INSTRUCTIONS 


The featured logical instructions are described in 14.3.1 through 14.3.7. (See Section 12 
for descriptions of the remaining logical instructions.) 
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AL 


14.3.1. Add Logical (AL) 










Possible Program Exceptions 





























OPCODE aE §§ ADDRESSING Wi PROTECTION 
a ane (J DATA (INVALID SIGN/DIGIT)| L] SIGNIFICANCE 
(Bytes) |] (] CECIMAL DiviDE W@ SPECIFICATION: 





0 DECIMAL OVERFLOW 

OD execute 

(0 EXPONENT OVERFLOW 
CO EXPONENT UNDERFLOW 
CO F1xX€D-POINT DIVIDE 

OD FIXED-POINT OVERFLOW 
LD FLOATING-POINT DIVIDE 
HB OPERATION 


NOT A FLOATING-POINT REGISTER 

OP 1 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON FULL-WORD BOUNDARY 


OP 2 NOT ON DOUBLE-WORD 
BOUNDARY 


OP 1 NOT EVEN NUMBERED REGISTER 
OP 1 NOT ODD NUMBERED REGISTER 
NONE 






Condition Codes 


M settoo 
@ serrtoi 
WM setto2 
@M settos3 
SEE OPER. CONSIDERATIONS 



















OOO O#8o000 


The add /ogical (AL) instruction logically adds the content of operand 2 to the content of 
the operand 1 register and places the sum in operand 1. 


Explicit Format: 








A OPERATION A 





LABEL OPERAND 







[symbol] 


Implicit Format: 








A OPERATION A 





LABEL OPERAND 







[symbol] 
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Operational Considerations: 





= Any of the general registers (0 through 15) can be used as operand 1. 

= The main storage location you specify in operand 2 must refer to a main storage area 
that is on a full-word boundary. Operand 2 is not changed by the execution of this 
instruction. 

= The addition is performed by logically adding the 32 bits of operand 2 to the 32 bits of 
operand 1. 

m Neither operand has a sign bit. 

a The condition code of the program status word (PSW) is set as follows: 

— to 0 if result is O (no carry of most significant bit); 
— to 1 if result is not O (no carry of most significant bit); 
— to 2 if result is O (carry of most significant bit); or 
— to 3 if result is not O (carry of most significant bit). 

2 The AL instruction is a featured instruction. An operation program exception is 
caused if you use this instruction and your processor does not have the control 
feature. 

Example: 

LABEL AOPERATIONA OPERAND 
| 10 16 

L 3, HEXVALU 

AL 3, FULLWORD 

DS OF 
HEXVALU DC X'$$969619' 


FULLWORD DC X'$$06G79C' 
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In this example, the main storage content of HEXVALU is placed into register 3. The 
AL instruction logically adds the full-word content of main storage location 
FULLWORD to the content of register 3 and places the sum in register 3. 


Register 3 before execution of AL instruction: 


0000! 0000 | 0000! 0000} 0000 ;0000 | 0001! 1001 


FULLWORD before execution of AL instruction: 











binary 


hex 













0000; 0000 0000! 0000 000010111 1001! 1100] binary 
1 


Register 3 after execution of AL instruction: 










0000! 0000 0000! 0000 0000/0111 10111010 binary 
t 
eielefe[ei pele] 
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ALR 


14.3.2. Add Logical (ALR) 


Possible Program Exceptions 


(J ADDRESSING (0 PROTECTION 

C(O DATA (INVALID SIGN/DIGIT) | [] SIGNIFICANCE 

(1 DECIMAL DIv!DE ( SPECIFICATION: 

OJ DECIMAL OVERFLOW NOT A FLOATING-POINT REGISTER 

OO Execute OP 1 NOT ON HALF-WORD BOUNDARY 

C0 EXPONENT OVERFLOW OP 2 NOT ON HALF-WORD BOUNDARY 

0 EXPONENT UNDERFLOW OP 2 NOT ON FULL-WORD BOUNDARY 

(0 FIXED-POINT DIVIDE OP 2 NOT ON DOUBLE-WORD 

(0 FIXED-POINT OVERFLOW BOUNDARY 

C0 FLOATING-POINT DIVIDE OP 1 NOT EVEN NUMBERED REGISTER 

@ OPERATION OP 1 NOT ODD NUMBERED REGISTER 
NONE 


OBJECT 
OPCODE FORMAT | INST. 


TYPE LGTH. 
(BYTES) 


Condition Codes 


M settoo 
W settoi 
@ setto2 
@ setto3 
SEE OPER, CONSIDERATIONS 











The add logical (ALR) instruction logically adds the content of the operand 1 register to the 
content of the operand 2 register and places the sum in operand 1. 


Explicit and Implicit Format: 







A OPERATION A OPERAND 


[symbol] 


Operational Goisidsralions 
= Any of the general registers (O through 15) can be used as operands 1 and 2. 
= The addition is performed by logically adding the 32 bits of operand 2 to operand 1. 
ws Neither operand has a sign bit. 
= The condition code of the program status word (PSW) is set as follows: 
— to 0 if result is O (no carry of most significant bit); 
— to 1 if result is not O (no carry of most significant bit); 
— to 2 if result is O (carry of most significant bit); or 


— to 3 if result is not O (carry of most significant bit). 
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= The ALR instruction is a featured instruction. An operation program exception is 
caused if you use this instruction and your processor does not have the control 
feature installed. 








Example: 
LABEL AOPERAT 1ONA OPERAND 
1 10 16 
L 3,VALUI 
L k ,VALU2 
ALR 3,4 
DS OF 
VALU] DC X'$GG9GG19' 
VALU2 DC X'$666679C ' 


In this example, the hexadecimal contents of main storage locations VALU1 and 
VALU2 are placed in registers 3 and 4, respectively. Then, the contents of registers 3 
and 4 are added and the sum placed in register 3. 





Register 3 before execution of ALR instruction: 








binary 


hex 


binary 


hex 
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EDMK 


14.3.3. Edit And Mark (EDMK) 


Possible Program Exceptions 


OBJECT || gw ADDRESSING W@ PROTECTION 


OPCODE | FORMAT | INST 
‘ DI IGNIFI N 
TBE recut. BB DATA (INVALID SIGN/DIGIT)| Os FICANCE 


(Bytes) ||) DECIMAL DIVIDE CD SPECIFICATION: 
C2 DECIMAL OVERFLOW NOT A FLOATING-POINT REGISTER 
OC Execute OP 1 NOT ON HALF-WORD BOUNDARY 


(C) EXPONENT OVERFLOW OP 2 NOT ON HALF-WORD BOUNDARY 
(CO EXPONENT UNDERFLOW OP 2 NOT ON FULL-WORD BOUNDARY 
ee CJ FIXED-POINT DIVIDE OP 2 NOT ON DOUBLE-WORD 
@ ser ro 1 0 FIXED-POINT OVERFLOW BOUNDARY 
B set T02 (C0 FLOATING-POINT DIVIDE OP 1 NOT EVEN NUMBERED REGISTER 
Ciset to 3 MM OPERATION OP 1 NOT ODD NUMBERED REGISTER 


(] SEE OPER. CONSIDERATIONS NONE 





The edit and mark (EDMK) instruction operates like the ed/t (ED) instruction except that it 
also saves the address of the first significant byte and places it in register 1. 


Explicit Format: 


LABEL AOPERATION A OPERAND 





[symbol] EDMK d, (I, b,), d, (b,) 


Implicit Format: 






LABEL A OPERATION A OPERAND 






[symbol] 
Operational Considerations: 


= The EDMK instruction operates like the ED instruction (see 9.6). After the packed 
content of operand 2 is edited and the unpacked result stored in operand 1, the 
address of the first nonzero character is placed in general register 1. 


a The condition code is set in the same manner as the ED instruction. 


o if the field to be edited contains no significant digits until after the significance 
starter, no address is moved into register 1, and the move instruction following the 
EDMK instruction will be using the incorrect address (or whatever value) that is in 
register 1. 


= To avoid having an incorrect address in register 1 because no significant digits exist 
before the significance starter, load register 1 with the address of the position where 
you want the insert character to be placed. 
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a = If a field to be edited contains multiple fields, the address of the first significant byte 
in each field replaces the one before. So in effect, the address of the first significant 
byte in the fast field is the final result. 


a The EDMK instruction is a featured instruction. An operation program exception is 
caused if you use this instruction and the processor does not have the control feature 
installed. 


= ~=6This instruction is used to insert a character in several places throughout the output 
display. For example: 


$6.25 
$86.00 
$2.34 
$724.11 


The location of the dollar sign is predicatable in that it appears at the left of the first 
significant digit on each line. The decimal point position also is predictable as the 
third character from the right. The proper positioning of a dollar sign or other 
message character is ensured by using the EDMK instruction. 








Example: 
LABEL AOPERATIONA OPERAND 
1 10 16 
MVC PATTERN ,MASK 
LA 1 ,PATTERN+7 
EDMK PATTERN, DATA 
s 1,=F'1! 
MVI 6(1),c'$! 
PATTERN DS cLi¢ 
MASK Dc X'4$26266B2626214B2926 ' 
DATA DC P'$245716' 


Register 1 before execution of EDMK instruction: 


2008 coer, Nesiabe | 0000 a hacia 
ee pee Oe) a 









0000 joooo binary 


hex 





address of PATTERN+7 
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@ Register 1 after execution of EDMK instruction: 


0000, 0000 0000; 0000] 0000 | 0000 










binary 
address of 1st significant digit 
Register 1 after execution of S instruction: 
0000 | 0000} 0000 ; 0000 /0000 ja000 binary 





address of byte to the left of 
ist significant digit 


Edited result after execution of MVI instruction: 


ist 

significant 
S digit 
Po a tet aN 


$ 
Orga cue Ofer ele 1111 pate orto 1011 frr41jot00 1111 jou 0100 jou 
ie ee ee 


In this example, the edit mask is moved into a 10-byte field labeled PATTERN. The 
address of the position where the insert character is to be placed (in the absence of 
significant digits before the significance starter) is loaded into register 1. Then DATA, 
containing the packed number, is edited and the result is placed in PATTERN. The 
address of the first significant byte (in this example, 2 is significant) replaces the 
content of register 1. Then a full word containing the decimal value 1 is subtracted 
from the content of register 1, therefore moving one byte to the left. The MVI 
instruction moves the dollar sign into the byte addressed by the content of register 1. 





binary 





hex 


eee eee 
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SLDL 


14.3.4. Shift Left Double Logical (SLDL) 


Possible Program Exceptions 


[7 ADDRESSING OC) PROTECTION 

C DATA (INVALID SIGN/DIGIT) | [] SIGNIFICANCE 

(2 DECIMAL DIVIDE @ SPECIFICATION: 

CO DECIMAL OVERFLOW NOT A FLOATING-POINT REGISTER 

CO execute OP 1 NOT ON HALF-WORD BOUNDARY 
CD EXPONENT OVERFLOW OP 2 NOT ON HALF-WORD BOUNDARY 
C] EXPONENT UNDERFLOW OP 2 NOT ON FULL-WORD BOUNDARY 
CO FIXED-POINT DIVIDE OP 2 NOT ON DOUBLE-WORD 


C] FIXED-POINT OVERFLOW BOUNDARY 
C0 FLOATING-POINT DIVIDE OP 1 NOT EVEN NUMBERED REGISTER 


Wl OPERATION OP 1 NOT ODD NUMBERED REGISTER 
NONE 








OBJECT 
OPCODE | FORMAT | INST. 










TYPE LGTH. 


Condition Codes 


Cl iF RESULT = 0, SET TOO 
OF RESULT <0, SET TO1 
Cif RESULT >0, SET TO 2 
OIF OVERFLOW, SET TO3 
MB UNCHANGED 























OOg oOoo00 





The shift left double logical (SLDL) instruction shifts all of the 63 bits of operand 1 to the 
left the number of bits specified by the low order six bits of the operand 2 address. Specify 
the even-numbered register of the pair as operand 1. 





Explicit Format: 








OPERAND 






A OPERATION A 





LABEL 






[symbol] 


Implicit Format: 


LABEL A OPERATION A OPERAND 


[symbol] 
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Operational Considerations: 





= =§=6Any pair of general registers (0 through 15) can be used as operand 1, which is an 
even-odd-numbered register pair. You must specify the even-numbered register of the 
pair as operand 1. 
= The main storage address or fabel you specify in operand 2 is not changed by the 
SLDL instruction execution. Notice the formats indicate that you cannot specify a 
length in operand 2. 
= After the requested number of bits are shifted out of the operand 1 register pair, 
zeros fill the rightmost bit positions of the register pair. 
= The SLDL instruction is a featured instruction. An operation program exception is 
caused if you use this instruction and your processor does not have the control 
feature. 
Example 1: 
LABEL AOPERAT |ONA OPERAND 
] 10 16 
LM 4,5, VALUE 
SLDL 4,32 
DS OF 
VALUE DC X'FFFFFFFF! 
DC X'FFFFFFFF' 


In this example, register 4 is loaded with the content of main storage location VALUE. 
Register 5 is loaded with the next 32 bits of main storage following VALUE. The SLDL 
instruction causes the contents of the registers to be shifted left 32 bits. 


Registers 4 and 5 before execution of SLDL instruction: 











































Register 4 Register 5 
' | { { t t ' 
a ae Ae ee ee at FleleyeFeleyerel ei & | hex 
Registers 4 and 5 after execution of SLDL instruction: 
PPT PEt efoto te [ete pele] 
tana daaaa | saggy aay 1111} 1111] 11111 1111] 0000 | o000 0000 | 0000 | 0000 ; 0000 | 0000! 0000 | binary 
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Example 2: 





This example using the SLDL has the same shift result except that a label is used as 
operand 2 of the SLDL instruction. 





1 10 16 
LM 4,5,VALUE 
SLDL 4 , STORAGE 
DS OF 
VALUE DC 2XL4'FFFFFFFF! 
STORAGE EQU X'2g! 


In this example, the absolute value of the main storage location STORAGE determines 
the number of bits that operand 1 should be shifted left. The operand 2 label is 
equated (EQU instruction) with a hexadecimal value that indicates how many bit 
positions you want to move. This is necessary so that the assembler takes the 
absolute value that you equated with your label and not its relocatable address. Note 
that a hexadecimal 20 is equivalent to a decimal 32. 





Registers 4 and 5 before execution of SLDL instruction: 
































| 
' 
sve fanaa sana tates [noses sata} oats ie ! wee PE ced em 
STORAGE before and after SLDL instruction execution: 
Lekes 
Registers 4 and 5 after SLDL instruction execution: 
pore freee nes fran rary rz [1171111 | 9000990 | 000 | 0000 0000 | 000 | 000} oo00 pio 
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SRDL 


14.3.5. Shift Right Double Logical (SRDL) 


Possible Program Exceptions 
OPCODE | FORMAT 
TYPE 


(1 ADDRESSING C] PROTECTION 
Condition Codes 


Clif RESULT = 0,SET TOO 
LJiF RESULT <0, SET TO1 
Clit RESULT >0, SET TO 2 
CF OVERFLOW, SET TO3 
BB UNCHANGED 




















ae... a 






















— (J DATA (INVALID SIGN/DIGIT)| [] SIGNIFICANCE 
| MNEM. |HEX. (BYTes) || [) DECIMAL DiviDE SPECIFICATION: 





CZ DECIMAL OVERFLOW 

OD execute 

(0 EXPONENT OVERFLOW 
CO ExPONENT UNDERFLOW 
C1 FIXED-POINT DIVIDE 

DC FIxED-POINT OVERFLOW 
(1 FLOATING-POINT DIVIDE 
WO OPERATION 


NOT A FLOATING-POINT REGISTER 

OP 1 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON FULL-WORD BOUNDARY 


OP 2 NOT ON DOUBLE-WORD 
BOUNDARY 


OP 1 NOT EVEN NUMBERED REGISTER 
OP 1 NOT ODD NUMBERED REGISTER 
NONE 












OOg OOOO0 


The shift right double logical (SRDL) instruction shifts the 64 bits of operand 1 to the right 
the number of bits specified by the low order six bits of the operand 2 address. You specify 
the even-numbered register of the pair as operand 1. 


Explicit Format: 









AOPERATION A 





LABEL OPERAND 


[symbol] 


Implicit Format: 


LABEL AOPERATIONA OPERAND 


[symbol] 
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Operational Considerations: 





a Any pair of the general registers (0 through 15) can be used as operand 1. Operand 1 
is an even-odd-numbered register pair. You must specify the even-numbered register 
of the pair as operand 1. 


= The main storage address or label you specify in operand 2 is not changed by the 
SRDL instruction execution. Notice the formats indicate that you cannot specify a 
length in operand 2. 


= After the requested number of bits are shifted out of the operand 1 register pair, O's 
fill the leftmost bit positions of the register pair. 


= The SRDL instruction is a featured instruction. An operation program exception 
results if you use this instruction and the processor does not have the control feature. 








Example 1: 
LABEL AOPERAT | ONA OPE RAND 
| 10 16 
LM 4,5, VALUE 
SRDL 4 32 
DS OF 
VALUE DC 2XL4, 'FFFFFFFF! 


In this example, registers 4 and 5 are loaded with the content of main storage 
location VALUE. The SRDL instruction causes the content of a register to be shifted 
right 32 bits. 


Registers 4 and 5 before execution of SRDL instruction: 


\ I 1 { ! t 


| 

Foy OF 
Registers 4 and 5 after SRDL instruction execution: 

0000 !ooo0 0000 | 000 0000 } 0000 0000} 0000 rn ae 












! 
Eafe 





















hex 


binary @ 


satay 494 





' 
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© Example 2: 


This example using the SRDL instruction has the same shift result, but a label is used 
as operand 2 of the SRDL instruction. 





LABEL AOPERATIONA OPERAND 
1 10 16 

LM 4,5, VALUE 

SRDL 4 , STORAGE 

DS OF 
VALUE pc 2XL4'FFFFFFFE! 


STORAGE EQU X'26' 


In this example, the absolute value of the main storage location STORAGE determines 
the number of bits that operand 1 should be shifted right. The operand 2 label is 
equated (EQU instruction) with a hexadecimal value that indicates how many bit 
positions you want to move. This is necessary so that the assembler takes the 
absolute value that you equated with your label and not its relocatable address. Note 
that a hexadecimal 20 is equivalent to a decimal 32. 


& Registers 4 and 5 before execution of SRDL instruction: 


I I I 
( ' { 
49794 199959174, 999177 1199) 1711 
! 





















ple hex 


| | 
1 ! 
444997179] 1191) 1111 





I 
111141111 


binary 


STORAGE before and after SRDL instruction execution: 


' 


0010} 0000] binary 





2°(32) 


Registers 4 and 5 after instruction execution: 


| | 1 
! l 
0000 ! 0000 } 0000 {0000 | 0000 | 0000 f 000; 0000 | 11111414} 1111 f1411 saa yanay fated agas 
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SL 


14.3.6. Subtract Logical (SL) 


Possible Program Exceptions 


@ ADDRESSING @ PROTECTION 

(CD DATA (INVALID SIGN/DIG!T) | [1] SIGNIFICANCE 

(J DECIMAL DivIDE W@ sPECIFICATION: 

OC DECIMAL OVERFLOW NOT A FLOATING-POINT REGISTER 
QOlexecute - OP 1 NOT ON HALF-WORD BOUNDARY 


OBJECT 
OPCODE FORMAT | INST. 


TYPE LGTH. 
(BYTES) 


Condition Codes 


QO) set too 
@ sertoi 
@ setrto2 
WM setTo3 
SEE OPER. CONSIDERATIONS 





(J EXPONENT OVERFLOW OP 2 NOT ON HALF-WORD BOUNDARY 
0 EXPONENT UNDERFLOW OP 2 NOT ON FULL-WORD BOUNDARY 
OO FIXED-POINT DIVIDE OP 2 NOT ON DOUBLE-WORD 


C] Fix€D-POINT OVERFLOW BOUNDARY 
CJ FLOATING-POINT DIVIDE OP 1 NOT EVEN NUMBERED REGISTER 


@ OPERATION OP 1 NOT ODD NUMBERED REGISTER 
NONE 







The subtract logical (SL) instruction logically subtracts the content of operand 2 from the 
content of the operand 1 register and places the result in operand 1. 


Explicit Format: 








A OPERATION A 






LABEL OPERAND 









[symbol] 


Implicit Format: 










LABEL A OPERATION A 





OPERAND 


[symbol] 
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@ Operational Considerations: 
= §©Any of the general registers (0 through 15) can be used as operand 1. 
=~ ~=6 The _label or address you specify in operand 2 must refer to a main storage location 
that is on a full-word boundary. Operand 2 is not changed by the execution of this 


instruction. 


= The logical subtraction is performed by adding the twos complement of operand 2 to 
operand 1. All 32 bits of each operand are used. 


= Neither operand has a sign bit. 

= ~=©The condition code of the program status word (PSW) is set as follows: 
— to 1 if result is not O (no carry of most significant bit); 
— to 2 if result is O (carry of most significant bit); or 
— to 3 if result is not O (carry of most significant bit). 


Zero code is not used. 


& = ~=6 The SL instruction is a featured instruction. An operation program exception is caused 
if you use this instruction and your processor does not have the control feature. 
Example: 
LABEL AOPERATIONA OPERAND 
1 10 16 
L 3 ,HEXVALU 
SL 3, FULLWORD 
DS OF ~~ 
HEXVALU DC X'SOOOOFFS ' 
FULLWORD DC X'PODBBEDS ' 
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In this example, the hexadecimal content of HEXVALU is placed in register 3. Then ® 


the twos complement of the content of main storage location FULLWORD is added to 
the content of register 3. 


FULLWORD before twos complement: 












hex 
0000}0000 0000} 0000 0000} 1110]0000} 1000 binary 
Twos complement of FULLWORD: 
! 
1111} 10001 binary 
hex 


Register 3 before execution of SL instruction: 










FI 8 
! 


0000/0000 }000010000]0000}1111]1111!1000] binary 


Register 3 after execution of SL instruction: 


I ! 
0000 0000 |00001 0000] 0000 }0001| 1111 !o000 


The twos complement of FULLWORD is added to the content of register 3. The result 
replaces the content of register 3. The condition code is set to 3, since the result is 


not O, and there is carryout (leftover 1 bit) of the leftmost bit. The carryout does not 
cause an overflow condition as would the subtract (S) instruction. 











hex 


binary 
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14.3.7. Subtract Logical (SLR) 


Possible Program Exceptions 
ObeabE __Sw__ [1 ADDRESSING [PROTECTION 
Oe Hale (J DATA (INVALID SIGN/DIGIT)| [] SIGNIFICANCE 


| mvem. |HEX. (Bytes) ||) DECIMAL DiviIDE OC) SPECIFICATION: 
0D DECIMAL OVERFLOW NOT A FLOATING-POINT REGISTER 
ran [fm | 2 osc” 


OP 1 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON FULL-WORD BOUNDARY 
OP 2 NOT ON DOUBLE-WORD 
BOUNDARY 
OP 1 NOT EVEN NUMBERED REGISTER 
OP 1 NOT ODD NUMBERED REGISTER 
NONE 


(J EXPONENT OVERFLOW 
: Condition Codes (1 EXPONENT UNDERFLOW 


Cl cer oe DD FIXED-POINT DIVIDE 
B serto1 (C FIXED-POINT OVERFLOW 
@ set to2 (J FLOATING-POINT DIVIDE 


WM setto3 i OPERATION 
SEE OPER. CONSIDERATIONS 


OOO Oo0O000 





The subtract logical (SLR) instruction logically subtracts the content of the operand 2 
register from the content of the operand 1 register and places the result in operand 1. 


Explicit and Implicit Format: 





A OPERATION A OPERAND 






[symbol] 






Operational Considerations: 
ws Any of the general registers (0 through 15) can be used as operands 1 and 2. 


a ~The logical subtraction is performed by adding the two’s complement of operand 2 to 
operand 1. All 32 bits of each operand are used. 


= Neither operand has a sign bit. 

a The condition code of the program status word (PSW) is set as follows: 
— to 1 if result is not O (no carry of most significant bit); 
— to 2 if result is O (carry of most significant bit); or 
— to 3 if result is not re) (carry of most significant bit). 


Zero code is not used. 
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= The SLR instruction is a featured instruction. An operation program exception is 
caused if you use this instruction and your processor does not have the control 





feature. 
Example: 
LABEL AOPERAT IONA OPERAND 
1 10 16 
L 3,VALUI 
L 5, VALU2 
SLR 3,5 
DS OF 
VALUI DC X'SPOOSFFSB' 
VALU2 DC X'SOAOGERE ' 


In this example, the hexadecimal contents of main storage locations VALU1 and 
VALU2 are loaded into registers 3 and 5, respectively. Then, the SLR instruction 
logically subtracts the content of register 5 from the content of register 3. 


Register 5 before twos complement: 


j 
0000 0000 |o000! o000 00001110 000011000} binary 





q44atadd 





I 
ane 


Register 3 before execution of SLR instruction: 











hex 


pofofojolole| 
0000} 0000] 0000} 0000] 0000! 1111 





binary 
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Register 3 after execution of SLR instruction: 


0000!0000] 0000} 0000] 0000} 0001 


The twos complement of register 5 is added to the content of register 3. The result 
replaces the content of register 3. The condition code is set’ to 3, since the result is 
not zero and there is a carryout (leftover 1 bit) of the leftmost bit. The carryout does 
not cause an overflow condition as would the subtract (SR) instruction. 







hex 





binary 











PART 4. BAL DIRECTIVES 
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15. Introduction to Directives 


The OS/3 assembly language includes assembler directives (Table 15—1) that enable the 
user to control assembler operation. Assembler directives control the assembler at assembly 
time just as application instructions control the processor at execution time. Housekeeping, 
program organization, assembly listing modification, and 1/O control are the tasks of the 
directives. 


The assembler application instructions the programmer uses to contro! the processor 
operation are discussed in Part 3 of this manual. The major portion of the program 
statements consists of these instructions. Just as there are mnemonics to direct the 
generation of the instructions, there are directives to control the operation of the software 
language processor (the assembler). These are called assembler directives. 


Table 15—1. Assembler Directives 


Types of Basic Function Where 

Directives Discussed 
EQUATE Symbol definitions Section 16 
OPSYM Delete operation code 


ASSEMBLER Control program name and Section 17 
CONTROL organization 


BASE REGISTER Directs registers to be Section 18 
ASSIGNMENT used and when 


LINKING AND Control of modules to be Section 19 
SECTIONING linked 


LISTING CONTROL Control of the assembly listing 


1/0 CONTROL Control of input/output data Section 21 
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16. Equate and Delete Operation 
Code Directives 


EQU 


16.1. EQUATE (EQU) 


The equate (EQU) directive defines the length and value of a symbol using another symbol 
as all or part of the definition. 


The format is as follows: 





A OPERATION A OPERAND 


where: 


Is an absolute or relocatable expression. 


Is an absolute expression. 
All symbols must be predefined. 


The symbol in the label field is defined as the value of the first expression in the operand. 
The maximum values are —2?23 to 2283—1. The length attribute of the symbol is equal to the 
second expression (a) if explicitly stated. If the second expression (a) is omitted, the symbol 
will have the length attribute of the first term in the first expression (e). If the first term is an 
* or a self-defining term, the length attribute of the symbol is 1. (See coding examples on 
following page.) 
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Examples: 

LABEL AOPERATIONA OPERAND 
1 10 16 

ba DS 25CL16 

2. EQU 1DB+TAG , 156 

3. EQU TAG+1279-* 

h, EQU TAG+1279-* ,296 

oe EQU 6 

6. EQU 1 





If the value of the location counter is 2000 when instructions 1 through 4 are 
encountered, the symbols have the following location counter values: 


1. TAG has a relocatable value of 2000 and a length attribute of 10. The location 
counter is advanced to 2250. 


2. HIDE has a relocatable value of 2100 (100 + 2000) and a length attribute of 150. 
The location counter remains at 2250. 


3. SEEK has an absolute value of 1020 (2000 + 1270 — 2250) and a length attribute 
of 10 (same as length of first term). 





4. If line 4 is substituted in place of line 3, then GO has an absolute value of 1020 
(2000 + 1270 — 2250) and a length attribute of 200. (The 200 overrides the 
length of TAG.) 


5. The registers O and 1 are equated to RO and R1. (See 6.1.) 
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OPSYM 


16.2. DELETE OPERATION CODE (OPSYM) 


The delete operation code (OPSYM) directive allows you to tell the assembler not to accept a 
certain mnemonic operation code. 


The format is as follows: 







AOPERATIONA OPERAND 





mnemonic OPSYM 
operation 


code 


After you use the OPSYM directive to declare a mnemonic code as unacceptable, the 
assembler will not generate the normal object code for that mnemonic if it appears after the 
OPSYM. You are then free to use the declared mnemonic another way, for example, as the 
mnemonic code of a macro prototype statement. 


Examples: 
LABEL AQPERATIONA OPERAND 
1 10 16 
1. MACRO 
2. A S QUANT ,&Q2,&SUM 
3. L 13,&QUANT 
k, A 13,6Q2 
5. ST 13,&SUM 
6. MEND 
]. START ) 
B.A OPSYM 
9 .| CALCU A PAY,RAISE, TOTAL 
10. END 


In this example, the program is preceded by a macro definition which is used in my program. 
Line 2 contains the mnemonic code A, which is the mnemonic operation code for an add full 
word instruction. Before | can call the A macro into my program, | must use an OPSYM 
directive to tell the assembler not to recognize A as the add full word mnemonic. The 
OPSYM directive must code before the line of code which references the macro, that is, line 
8 must precede line 9. 


The OPSYM directive cannot be used from within a PROC/MACRO or from within code 
generated as a result of conditional assembly statements. 
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17. Assembler Control Directives 


Assembler contro! directives are available to name the program and specify an initial 
location counter, section the program, alter the location counter to a specified value, 
indicate the end of a program, and designate the instruction the program will begin with. 
Table 17—1 is a summary of the assembler control directives available to the user of the 
OS/3 assembler. 


Table 17—1. Assembler Control Directives 


Directives Basic Function Where 
Discussed 
CNOP Condition no operation 1 
END 
1 











7.1 
peo | Program end 
Generate literal pool 
7.4 
17.5 







1 
ORG Specify location counter Fie 
START Program start pos 
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17.1. CONDITION NO OPERATION (CNOP) 


The condition no operation (CNOP) directive adjusts the location counter to a half-word, full- 
word, or double-word storage boundary. The format of the CNOP directive is: 





A OPERATION A OPERAND 


where: 


a, and a) 
Are absolute expressions consisting of predefined terms. 


The first expression in the operand field indicates a byte to which the location counter must 
be set. Legal values for the first expression are O and 2 for full-word boundary alignment, 
and O, 2, 4, and 6 for double-word boundary alignment. 

a O indicates a full-word or double-word boundary; 

= 2 indicates the second byte (first half word) past the boundary; 

= 4 indicates the fourth byte (second half word) past a double-word boundary; and 


a 6 indicates the sixth byte (third half word) past a double-word boundary. 


Permissible values for the second expressions are 4 and 8, indicating that the adjustment is 
relative to a full-word or double-word boundary, respectively. 


If the location counter is already set to the indicated byte, the CNOP has no effect. When 
alignment is needed, one, two, or three no-operation instructions are generated to 
increment the location counter to the proper half-word boundary and to ensure correct 
instruction processing. All terms must be predefined. 
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Examples: 
LABEL AOPERATIONA OPERAND 
1 10 16 
1. CNOP $,8 
2. CNOP 2,4 





1. The current location counter is advanced, if necessary, to the first byte of the next 
double-word boundary. A legal double-word boundary is any address value 
divisible by 8. 


2. The current location counter is advanced, if necessary, to the second byte (first 
half word) past the next full-word boundary. A legal full-word boundary is any 
address value divisible by 4. 
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END 


17.2. PROGRAM END (END) 





The program end (END) directive indicates the end of a source program or macro definition 
written in PROC format. (See Appendix A and Section 25.) 


The format of the END directive is: 








A OPERATION A OPERAND 


[symbol] 


where: 


Is a relocatable expression. 


The END directive must be the last statement in the source program. An expression in the 
operand field designates the point in the program where control may be transferred after 
the program is loaded. If the END directive is missing, an END directive with a blank operand 
field is supplied by the assembler. If the END directive terminates a proc, the label and 
operand fields are not used. 


Examples: 
LABEL AOPERAT IONA OPERAND 
1 10 16 
1.| FOX END BEGN 
2. END G0+324 
3. END 


All three of the END statements halt assembly, but each transfers control to a different 
address in the program. 


1. Control is transferred to a statement labeled BEGN in the program. The label FOX 
is assigned the address associated with the last byte of the assembly. 


2. If GO has a value of 1000, control is transferred, and the next instruction to be 
processed is located at address 1324. 


3. If no operand is specified, control is transferred to the first address of the program 
loaded. 
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LTORG 


17.3. GENERATE LITERALS (LTORG) 


The generate literal pool (LTORG) directive generates all literals previously defined into a 
data pool within the source program. The format of the LTORG directive is: 






A OPERATION A OPERAND 


[symbol] 


The literals are pooled following the occurrence of the LTORG directive. A symbol in the 
label field represents the first byte of the generated literal pool and is assigned a length 
attribute of 1. LTORG directives may not appear within a dummy control section (19.3) or in 
a blank common storage area. If there are no LTORG statements in a program and literals 
are specified, or if any literals are specified after the last LTORG directive in a program, 
these literals are pooled at the end of the first control section. The programmer then must 
ensure that a valid base register is available to address the locations in the literal pool. 


Literals are placed in the literal pool according to their total length (duplication factor 
multiplied by the length of the constant). The literal pool consists of four sections: 


1. Literals with total lengths that are multiples of double words (eight bytes) 
2. Literals with total lengths that are multiples of full words (four bytes) 
3. Literals with total lengths that are multiples of half words 


4. Any remaining literals 


Within each pool section, the literals are stored in order of occurrence. Before the literal 
pool is generated, the location counter is adjusted to a double-word boundary. If two control 
sections are assembled together and a LTORG is not included in the second or following 
sections, then all the literals defined in all the sections will be pooled in the first control 
section and may subsequently be available only to that first section. To ensure that each 
linked control section can use the literals declared by it, an LTORG should be used within 
each control section. 
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ORG 


17.4. SPECIFY LOCATION COUNTER (ORG) 


The specify location counter (ORG) directive sets or resets the location counter to a specified 
value. The format of the ORG directive is: 







AOPERATIONA OPERAND 


[symbol] 


where: 


Is a relocatable expression. 


The location counter is set to the value of the expression in the operand field. When no 
expression is present, the location counter is set to the highest location previously assigned 
in that control section. A symbol in the label field has the same value as the expression in 
the operand field and is assigned a length attribute of 1. The expression in the operand field 
must be relocatable. Its value must represent an address in the same control section in 
which the ORG occurs. This address value must be equal to or greater than the initial 
setting of the current location counter. If the expression is in error, the ORG directive is 
ignored, and the line is flagged. All terms in the expression must be predefined. 


The ORG directive permits the location counter to be set to a value not on a half-word 
boundary. 


Bytes of storage reserved with an ORG directive are not set to zero or cleared when the 
program is loaded. 





Example: 
LABEL AOPERATIONA OPERAND 
1 10 16 
AREA ORG *+A+B 


This statement reserves A plus B bytes of storage, where A and B are previously defined 
symbols with absolute values. If A = 80, B = 160, and the value of the location counter is 
1048, then 240 bytes are reserved beginning at the location 1048. 


Additional examples of the ORG directive are included on the following page. 
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@ Examples: 
LABEL AOPERATIONA OPERAND ACOMMENTS 
] 10 16 
Seca eee ore ee eh ee ee 
1. | INPUT DS CL8¢ INPUT FIELD 8@ BYTES 
2. ORG INPUT INPUT FOR RECI 
REC] DS CL2¢ 
FLDI DS CL6G 
3. ORG INPUT INPUT FOR REC2 
REC2 DS CL3¢ 
FLD2 DS CL3¢ 
FLD22 DS CL2¢ 
4, ORG INPUT INPUT FOR REC3 
REC3 DS CLIS 
FLD3 DS CL25 
FLD33 DS CL4G 


1. An input area for an 80-byte card is defined with no subfields. 
2. The input field is redefined in place to show two subfields. 


@ af 


4. Redefine INPUT for different organizations of the field. 


Instructions 1 through 4 define four different types of cards or other 80-byte records. 
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START 


17.5. PROGRAM START (START) 


The program start (START) directive defines the program name, the name of the first control 
section, and the initial location counter value. The format of the START directive is: 







AOPERATION A OPERAND 


[symbol] 


where: 


Is an absolute expression. 


A symbol in the label field becomes the name of the first or only control section in the 
program. If the label field is blank, an unnamed control section is begun. All statements 
following the START directive are assembled as part of the control section until another 
unique control section definition is encountered. 


The label field of a CSECT directive, which can contain the same name as the label field of 
the START directive, identifies the continuation of the control section. A blank label field in 
the CSECT directive identifies the continuation of an unnamed control section that began 
with an unnamed START directive. 


The symbol in the label field of the START directive also identifies or names the object 
program. If the START directive is unnamed, the object module is assigned the name 
ASMOBJ. The symbol must be a valid symbol. It is an automatic entry point and has a 
length attribute of 1. The START directive must not be preceded by any statements which 
would initiate a control section. 


The self-defining term in the operand field of the START directive establishes the initial 
location counter value for the first control section. If the self-defining term represents a 
value which is not a multiple of 8, the START directive is flagged and the location counter 
set to the next higher multiple of 8. If the operand is omitted, the initial control section is 
assigned a location counter value of zero. 


Examples: 
LABEL AOPERATIONA OPERAND 
] 10 16 
TEST START 1663 
TEST START X'427! 


The location counter contents for either of these statements would be 1064, which is the 
next higher multiple of 8 from 1063. 
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18. Base Register Assignment Directives 


The OS/3 assembler converts storage addresses to base register and displacement values 
for insertion into instructions being assembled. To do this, the assembler must be informed 
of the available registers and the values assumed to be in those registers. The assembler 
directives USING and DROP are available for this purpose. 


= The unassign base register (DROP) directive informs the assembler that certain 
registers are no longer to be used for base registers. 


= §=6The assign base register (USING) directive informs the assembler that the specified 
registers are available for use as base registers. 
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DROP 


18.1. UNASSIGN BASE REGISTER (DROP) 


The unassign base register (DROP) directive informs the assembler that the registers 
specified are no longer available for base register assignment. The format of the DROP 
directive is: 








LABEL A OPERATION A OPERAND 





where: 


rL---¥nl 
Specifies that the declared registers (O through 15) are no longer available for 
base register assignment. 


Registers previously made available for base register assignment may be dropped and made 
available again in a USING directive. (See 18.2.) The value assumed to be in a base register 


may be changed by coding another USING directive without an intervening drop of that 
register. 


Examples: 


LABEL AOPERATIONA OPERAND 
1 10 16 


: DROP 1 
2. DROP 1,3,4 


1. This directive specifies that register 1 is no longer available to the assembler for 
base register assignment. 





2. This directive specifies that registers 1, 3, and 4 are no longer available for base 
registers. 
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USING 


18.2. ASSIGN BASE REGISTER (USING) 


The assign base register (USING) directive informs the assembler that a specified register is 
available for base register assignment and will contain a specific value at execution time. 
The value must be loaded by the program into the base register that the USING directive 
specifies. The assembler maintains a USING table of the specified registers. The format of 
the USING directive is: 





A OPERATION A OPERAND 


where: 
Vv 
Is the value assumed to be in the first specified register at execution time. This 
value may be relocatable or absolute. Literals are not permitted. 
HL. y] 


Specifies that the declared registers (O through 15) will be used as base registers 
loaded at execution time. These register numbers do not necessarily have to be 
assigned in ascending sequence. 


The first register specified after v is assigned the value of v; the next register is assigned the 
value of the first register plus 4096; the next register is assigned the value of the second 
register plus 4096; and so on through all the registers specified. A USING directive may 
specify a single register or a group of registers, or the registers may be specified by 
individual USING directives. 


Register O may be specified as a valid base register; however, the assembler assumes that it 
always contains the value O and calculates displacements as if the operands were zero. 
Register O must be the operand specified by r,, and any registers specified in the operand 
field following register O are assumed to contain increments of 4096 from zero. 


When v is absolute, the indicated registers may be used to process only absolute effective 
addresses. 


When v is relocatable, the indicated registers can be used to process only relocatable 
effective addresses. The registers r,,...,7, are used to process only those addresses in the 
same control section as the address represented by v. 


The value specification in a USING directive sets the lower limit of an address range; the 
upper limit is automatically set 4095 bytes above the lower limit. The upper limit of a 
USING directive may be set less than 4095 bytes by being overlapped by the lower limit of 
another USING directive. 
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The range specified by a USING directive is used by the assembler to assign base register 
and displacement values to those effective operand addresses that fall within that range. 


If an operand address is specified as an effective address instead of a base register and 
displacement specification, the assembler searches the USING table for a value yielding a 
displacement of 4095 or less; if there is more than one such value, the value that yields the 
smallest displacement is chosen. If no value yields a valid displacement, the operand 
address is set to zero, and the line is flagged with an error indication. If more than one 
register contains the value yielding the smallest displacement, the highest numbered 
register is selected. 


Examples: 


LABEL AOPERATIONA OPE RAND 
! 10 16 





1 USING 4699 ,8 

2. USING 8600,1,2,3,6,7,8, 12 
3. US ING *, 

4, US ING TAG,R9 


1. A range of 4096 bytes is covered by register 8 at location 4000 through 8095. The 
value 4000 is assumed to be stored in register 8. 


2. The value 8000 is assumed to be in register 1, 12096 in register 2, 16192 in 
register 3, 20288 in register 6, 24384 in register 7, 28480 in register 8, and 
32576 in register 12. These register numbers and their assumed values are 
entered into the USING table in the order specified. 


3. Register 5 is used as the base register, with the value of the location counter 
contained in register 5. 


4. The register declared by the symbol R9 is assumed to contain the base address 
of the symbol “TAG”. 
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19. Program Linking and 
Sectioning Directives 


A program or a portion of a program assembled as a single unit is called a module. A 
complex program may consist of many modules; some may be standard subroutines that 
can be used in any program. 


The assembler provides, as part of its output, information that allows modules to be linked 
together, loaded and then executed as a single program. Proper partitioning or sectioning 
reduces the execution time required to make changes to an existing program. If a change is 
required, only the module that is changed must be reassembled. The output is then linked 
with the remaining parts to produce the altered program. Proper partitioning of a program 
also reduces the number of symbols required in each of the separate assemblies. 


A symbol defined in the label field of module A and addressed in module B must-be 
externally defined by an ENTRY directive in module A and defined by an EXTRN directive 
in module B. By using the ENTRY and EXTRN directives, proper linkage is supplied when 
the separate modules are assembled. This information is passed to the linkage editor by 
the external definition records and the external reference records, which are outputs of 
the assembler. 


The assembler also provides an optional capability of dividing one module into different 
sections. A control section is a group of instructions, constants, and storage areas, the 
positions of which, relative to each other, are fixed and must remain fixed to ensure proper 
coding. Proper execution of instructions and data in one control section must not depend on 
their positions relative to instructions or data in any other control section. Because the 
assembler maintains a separate location counter for each section, control sections may 
appear in any order for input to the assembler. Statements belonging to one control section 
may be intermixed with statements belonging to one or more other sections. If the first 
statement of a control section is a START directive, its label names the control section. 


Each module may have a maximum of 255 external symbol identification (ESID) items. An 
ESID item contains special information used by the linkage editor in relocating modules and 
module sections and in resolving references between modules. The following items cause 
the assembler to generate an ESID item: 


@ Each unique symbol used in a V-type address constant 
a Each symbol used in a V-type address constant 
. Each control section 


a Each dummy control section 


™ Each common storage definition section 
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19.1. COMMON STORAGE DEFINITION (COM) 


The common storage definitior (COM) directive enables the programmer to define a control 
section which is a common storage area for two or more separately assembled routines. The 
format of the common section may be described by DS and DC directives. Labels appearing 
within the sections are defined. Like a dummy control section, no data or instructions are 
assembled in a common section. It has a separate location counter with an initial value of 
zero. Data may be entered into a common section only by execution of a program which 
refers to it, or by loading a contro! section of the same name. Such CSECTS are called block 
data sections. DC instructions act as DS instructions in the COM area because neither 
instructions nor constants in a common storage area are assembled. Labels defined in a 
common section are not subject to the restrictions imposed on dummy section labels. 


One assembly can define only one blank (unnamed) common section. Several like-named 
COM directives may appear among the source statements. Each COM directive after the 
first defines a continuation of the common section previously described. When several 
routines defining like common storage are linked, the resulting module contains only one 
section corresponding to the like common sections in the input modules. The length of this 
section is the length of the largest like common section in the input modules. The format of 
the COM directive is: 






A OPERATION A OPERAND 


[symbol] 


If the common section is unlabeled, the area is addressed by referencing the label of a 
statement within the common section with a USING directive. (See 18.2.) 


Examples: 

MODULE 1: 
LABEL AOPERATIONA OPERAND 
| 10 16 

1.) M001 CSECT 

2 .| ACOM COM 
REBEW DS CLI25 
CHAYA DS CL8¢ 
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© MODULE 2: 
LABEL AOPERATIONA OPERAND 
1 10 16 
3.1 MOD2 CSECT 
4.) ACOM COM 
ELI 0S CL266 
END 


1. When module 1 is assembled, it uses the common storage area defined by line 2. 
2. The common storage area used by module 1 and module 2 


3. When module 2 is assembled, it also uses the common storage area defined by 
line 2 


4. The common storage area used by module 1 and module 2 


The common storage area for these examples is 260 bytes long (see following listing). 
The fields REBEW and CHAYA are the same storage area as the first 205 bytes of the 
field ELI. 


Byte Hexadecimal Module 1 Hexadecimal 
Number Address Address 


ACOM COM 
0 00000 
125 0007D 
205 
260 


REBEW DSS CL125 

lf more than one object module element refers to a common storage area with the 
same name, the references are to the same storage area. Only one common storage 
area is allocated within a load module to satisfy all object module requests for common 
storage areas with the same name. The size of a common storage area in a load 
module is determined by the maximum size requested by any object module for 
common storage with that name. Blank common storage areas are allocated in the 
same way. 















ACOM COM 


ELI DS CL260 





CHAYA DS CL80 


END 


In a multiphase load module, common storage areas are not normally overlaid. 
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The following rules apply to the use of common storage: 


An entry point cannot have the same name as a labeled common storage area 
included in the load module. 


When the linkage editor includes module elements (CSECT or COM) with the same 
name as a labeled common storage area, that section is treated as a block data 
subprogram (i.e., to initialize values of labeled common blocks) and is loaded into 
all or a portion of the common storage area. A block data subprogram is loaded 
when the phase in which it was included is loaded. Blank common cannot be 
initialized during loading unless the text encountered is for that COM ESD. 


If an object module has requested common storage, the partial inclusion of a 
single control section from that object module will cause the common storage area 
defined to be included also, regardless of whether or not the included control 
section refers to that common storage name. For further information, see the 
linkage editor portion in system service programs (SSP) user guide, UP-8062 
(current version). 
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19.2. CONTROL SECTION IDENTIFICATION (CSECT) 


The control section identification (CSECT) directive indicates to the assembler the initiation 
or continuation of a control section. The format of the CSECT directive is: 






AOPERATION A OPERAND 


[symbol] 


The symbolic name of the control section defines an entry point of the program being 
assembled. This symbol must not appear as a symbol for any other source statement except 
the START directive of its control section or another CSECT directive to indicate 
continuation of the coding in the same control section. 


Each contro! section is adjusted to begin on a double-word boundary. The value of the 
symbol is the address of the first byte of the control section and has a length attribute of 1. 


If the symbol is blank, the CSECT directive is a continuation of coding for an unnamed 
control section. If the symbol is blank and is not preceded by an unnamed control section, 


the CSECT initiates an unnamed control section. Only one unnamed contro! section is 
permitted in a module. 


Examples: 


LABEL AOPERATIONA OPERAND 
1 10 16 


1.}GROSS START 


2.;DEDUCT CSECT 


3.|GROSS CSECT 


END 
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LABEL AOPERATIONA OPERAND 
] 10 16 





4] GROSS2X CSECT 


5.] DEDUCTX CSECT 


6.| GROSS2X CSECT 


END 


1. The first control section of coding is labeled GROSS. 





2. The second control section of coding is labeled DEDUCT. 

3. The coding beginning at line 3 is a continuation of the section labeled GROSS. 
4. The first control section of coding is labeled GROSS2xX. 

5. The second control section of coding is labeled DEDUCTX. 


6. The coding beginning at line 3 is a continuation of the section labeled GROSS 2x. 
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19.3. DUMMY CONTROL SECTION IDENTIFICATION (DSECT) 


A program may contain references to areas that have been defined in other modules. 
Addressing such areas is facilitated by describing the area and its format to the assembler 
as a dummy control section. Any statement following a dummy control section identification 
(DSECT) directive is identified as belonging to the dummy control section. The format of the 
DSECT directive is: 






LABEL AOPERATION A OPERAND 





[symbol] 


Storage is not reserved by a DS directive within a dummy control section, and the data and 
instructions appearing in a dummy control section do not become part of the assembled 
program. A separate location counter with an initial value of zero is kept for each dummy 
control section. More than one DSECT directive with the same symbol may appear in a 
module. The first DSECT directive initiates the dummy control section; the remaining DSECT 
directives continue it. 


Symbols of statements in a dummy control section are called dummy section symbols. The 
following rules must be observed in using and assigning dummy section symbols: 


= An unpaired dummy section symbol may appear only in an expression defining a 
storage address for a machine instruction or an S-type constant. 


= A base register may not be specified for an address field containing an unpaired 
dummy section symbol. 


= The programmer must ensure that the appropriate value is loaded into the register 
specified in the USING statement. 


To guarantee alignment between the actual storage area and the dummy control section, 
the user should align the storage area to a double-word boundary. 


Coding examples utilizing the DSECT directive are included on the following page. 
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Examples: 
LABEL AOPERATIONA OPERAND ACOMMENTS 
1 10 16 
( AT EEO 
BEGIN BALR R3,8 
USING *R3 
L R4,AREA 
US ING SECTION, R4 REGISTER 4 FOR DSECT 
MOVE MVC WORK (3) , CODE 
MVC WORK] (28) , NAME 
AREA DC A(TABLE) 
1.] SECTION DSECT 
NAME DS CL28 
NUMBER ODS CLI5 
CODE DS CL3 
WORK DS CL3 
WORKI DS CL28 
2. CSECT 
TABLE DS CL5d 
END 





1. The coding following DSECT is assigned to a dummy control section. 


2. CSECT begins a new control section or continues the current control section. 
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19.4. EXTERNALLY REFERENCED SYMBOL DECLARATION (ENTRY) 


Each module must declare to the assembler the symbols defined within the module to 
which reference is made by other modules. Each symbol is referred to as being externally 
referenced and is declared by the ENTRY directive. The format of the ENTRY directive is: 






A OPERATION A OPERAND 





symbol [,symbol.,...,symbol] 


Each symbol in the operand field is declared to be defined in this module. Their name and 
assigned values are included in the output of the assembler as external reference records. 


(See 19.5.) 


Example: 
LABEL AOPERATIONA OPERAND 
] 10 16 
ENTRY WRD32 ,REBEW, ILE, CHAYA 


WRD32, REBEW, ILE, and CHAYA are symbois defined in module 1 for the use of other 
modules. ENTRY permits other modules to reference the symbol defined by the ENTRY 
directive declaring it. 
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19.5. EXTERNALLY DEFINED SYMBOL DECLARATION (EXTRN) 


The assembler must be informed of all symbols used in the module being assembled that 
are defined in some other module. References to these symbols are called external 
definitions; these symbols are declared in the externally defined symbol declaration 
(EXTRN) directive. The format of the EXTRN directive is: 







A OPERATION A OPERAND 


unused symbol [,symbol.,...,symbol] 





Each symbol in the operand field is declared to be a symbol defined in some other module. 
(See 19.4.) The symbolic name and the external symbol identification assigned by the 
assembler are input to the linkage editor as an external definition record. Each reference 
to the externalized symbol creates an appropriate relocation mask to allow reference 
resolution at linkage editor time. When an EXTRN and a definition for an identical symbol 
appear in the same assembly, the EXTRN reference is discarded automatically, and the 
definition is accepted regardless of the order of appearance of either item. 


Examples: 
MODULE A: 
LABEL AOPERATIONA OPERAND 
] 10 16 
FOX MVO DEST(5) , ORIG (3) 
DC A(CAT) 
DC A(DOG) 
JOE BC 8, 1648 
MAT BCT 19, SET 
DC A(P IG) 
ENTRY FOX,JOE,MAT 


EXTRN CAT ,DOG,PIG 
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MODULE B: 
LABEL AOPERATIONA OPERAND 
1 10 16 

DC A(FOX) 
CAT PRINT DATA 

DC A(JOE) 
DOG MVC NAHS, NAD 

DC A(MAT) 
PIG AU 6,UNOR 

ENTRY CAT, DOG,PIG 

EXTRN FOX, JOE ,MAT 


In module A, the symbols FOX, JOE, and MAT are specified with the ENTRY directive so that 
they may be used in module B as specified by EXTRN. 


In module B, the symbols CAT, DOG, and PIG are specified with the ENTRY directive so that 
they may be used in module A as specified by EXTRN. 


19.6. SUBROUTINE LINKAGE 


in addition to writing the code in your external subroutines, you must provide for certain 
conventions that link your subroutines to your program. The conventions are: 


= Saving and restoring the contents of the registers 
: Establishing a new base register 
= Branching back to the program 


Each of these conventions uses a specific register. The table that follows lists the registers 
and their use. 
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Register Use 
1 Contains the address of the table holding variables being passed to the 
subroutine. 
13 Contains the address of an 18-word area that will save the contents of the 


registers as they were before your subroutine began execution. 


14 Contains the address that your program branches to after it finishes its 
execution. 
15 Used as the base register 


The format that follows shows how you should use these registers to meet these 
conventions. 


LABEL AOPERATION A OPERAND 
1. symbol: CSECT 
2. STM 14,12,12(13) 
3. BALR 15,0 
4 


USING * 15 





processing code here 


5. LM 14,12,12(13) 
6. BR 14 





storage definition (if any) 


7. END 


1. This line uses the CSECT directive to name the subroutine. 


2. This line saves the contents of the registers in an 18-word save area located at 
the address stored in register 13. 


3. These two lines establish register 15 as the base register for the execution of the 
and_ subroutine. 
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5. This line restores the contents of the registers from an 18-word save area 
located at the address stored in register 13. 


This line returns control to your program by branching to the address stored in 
register 14. 


7. This statement must be the last line in the subroutine. 
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20. Listing Control Directives 


One of the outputs of the assembler process is a listing of source and object codes. The 
assembler directives that control the format of the listing have the following functions: 


™ Provide headings for each page 

7 Eject or skip to a new page 

= Space for extra blank lines 

= Provide for printing or nonprinting of the output 


Table 20—1 is a summary of the assembler listing control directives available to the user 
OS/3 assembler. 


Table 20—1. Listing Control Directives 


Directi Basic Function wee 

irectives asic ctio Discussed 
EJECT Advance listing 
SPACE Leave blank lines on listing 
TITLE Listing title declaration 
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20.1. ADVANCE LISTING (EJECT) 


The advance listing (EJECT) directive causes the assembler to continue the assembly listing 
(Part 6, Section 28) on the top of the next printout page. The format of the EJECT directive 
is: 





A OPERATION A 





OPERAND 


If the next line of the listing causes a page change, the EJECT directive has no effect. 


When the EJECT directive is encountered, the printing form is skipped to the next page. If a 
title has been previously specified, the title is printed on the new page. An EJECT directive 
appearing in a source code macro definition causes the form to be skipped whenever the 
definition is listed and each time the macro is generated. 


The assembler will advance the assembly listing to a new sheet whenever a sheet is full. 
However, if the programmer would like each new logical part or subroutine to start at the 
top of a new sheet, he can use the EJECT directive whenever he wants a new sheet to Start. 


The EJECT directive itself is never printed. 
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20.2. LISTING CONTENT CONTROL (PRINT) 


The /isting content control (PRINT) directive enables the programmer to control the contents 
of the assembly listing. The format of the PRINT directive is: 










LABEL A OPERATION A OPERAND 











unused (Dats \ (ane 
U " |DOUBLE 
where: 
ON 
Specifies the listing is to be printed. 
OFF 
Specifies that no listing is printed. 
GEN 
Specifies that lines generated by a macro instruction are printed. 
NOGEN 
Specifies that lines generated by a macro instruction are not printed, except that 
the macro instruction and any MNOTE or PNOTE messages generated are printed. 
DATA 
Specifies that all characters of each constant representation are printed. 
NODATA 
Specifies that only the first eight characters of each constant representation are 
printed. 
SINGLE 
Specifies that the source listing is single-spaced. 
DOUBLE 


Specifies that the source listing is double-spaced. 
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If a PRINT directive specifies OFF plus other parameters, the other specifications are not 
effective until a PRINT directive is encountered that specifies the listing is to be turned ON. 
The options provided by the PRINT directive are keyword and not positional parameters; 
therefore, the comma is not required if a parameter is omitted. The initial print condition of 
assembly printing is ON, GEN, NODATA, SINGLE. This condition remains until the first 
PRINT directive changes it. PRINT directives may change from only one to all of the 
parameters; any unspecified parameters remain in their previous condition. A PRINT 
directive may not appear in a macro definition. 





Examples: 
LABEL AOPERATIONA OPERAND 
! 10 16 
Is PRINT DATA 
2. PRINT OFF 
3. PRINT ON ,GEN, DATA 


1. Data is printed in full. 
2. Assembly listing is suppressed. 


3. Assembly list printing is restored with complete printing of data constants. 
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20.3. LEAVE BLANK LINES ON LISTING (SPACE) 


The /eave blank lines on listing (SPACE) directive causes the assembler to advance the 
paper in the printer a specified number of lines. The operand field contains an unsigned 
decimal integer specifying the number of lines the paper is to be advanced. If no operand is 
coded, one line will be spaced. 





A OPERATION A OPERAND 







unused 


where: 
i 
Is an unsigned decimal integer. 
Examples: 
LABEL AOPERATIONA OPERAND 


1 10 16 
| SPACE 6 
2. SPACE 22 


1. The assembler advances the print form six lines before printing the next line. 


2. The assembler advances the print form 22 lines before printing the next line. 
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20.4. LISTING TITLE DECLARATION (TITLE) 


The /isting title declaration (TITLE) directive provides data for the heading of each page of 
the assembler listing and advances the printer form to a new page. The format of the TITLE 
directive is: 





AOPERATION A OPERAND 


where: 


Is a heading of up to 100 characters enclosed in apostrophes. 


The following conditions apply to characters in the operand field: 

= Any character may be specified, including spaces, within the defining apostrophes. 
= An apostrophe within the operand must be specified as a pair of apostrophes. 

= An ampersand within the operand must be specified as a pair of ampersands. 

u Spaces may be specified freely to separate heading words. 


More than one TITLE directive is permitted in a program. A TITLE directive provides the 
heading for all pages in the listing which succeed it. 





Examples: 
LABEL AOPERATIONA OPERAND ACOMMENTS 
] 10 16 72 
l. TITLE ' WEEKLY PAYROLL SOURCE AND OBJECT LISTING -- ASSEMBLED Z 
ON &SYSDATE AT &SYSTIME! 
2. TITLE ' PAYROLL SUBSECTION -= &SYSDATE! 


1. The Z in column 72 specifies that the title is continued on the next line. At 
assembly time, the assembler replaces the system variable symbols &SYSDATE 
and &SYSTIME with the current date and time, respectively. (See Appendix G.) 


2. The assembler puts the system date in &SYSDATE at assembly time. 
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21. Input and Output Control Directives 


The OS/3 assembler input and output control directives provide the necessary control for 
sequence checking, formatting, and reproducing data. The directives in this section help you 
in writing the source code program and controlling the source code punched cards. The six 
directives are: 
= ICTL 

Controls the format of the program instructions. 
=» ISEQ 

Controls the sequence of the punched cards in the source deck. 
= REPRO 

Controls the production of linkage editor control statements in the object module. 
= PUNCH 

Produces a specified record at assembly time. 
= COPY 

Controls the inclusion of prefiled source statements into your source programs. 


e CCW 


Initiates input and output operations. 
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21.1. INPUT FORMAT CONTROL (ICTL) 


The input format control! (ICTL) directive specifies new values for the begin, end, and 
continue columns. Normally, a source statement begins in column 1 of the coding form and 
ends in colum 71. If a continuation statement is needed, a character is written in column 
72, and the statement continues in column 16 of the following line. The format of the ICTL 
directive is: 





A OPERATION A OPERAND 






[b] [,e] [,c] 






where: 

b 
Is an unsigned decimal integer specifying the beginning column. It must be 
between 1 and 75. 

e 
Is an unsigned decimal integer specifying the ending column. It must be greater 
than or equal to b+5 and less than or equal to 80. 

c 


Is an unsigned decimal integer specifying the continuation column. It must be 
greater than b and less than e. The line is continued starting in the column 
specified by c. 


If b is omitted, it is assumed to be 1. If e is omitted, it is assumed to be 71. If c is omitted 
or if e equals 80, continuation records are not allowed. If e is specified and e is less than 
80, a continuation statement is signalled by putting a nonblank character in column e+1 
of the line to be continued. 


There can be only one ICTL directive in a source code module and it must immediately 
precede or follow any program-defined macro definitions. The ICTL directive applies only to 
those source statements that follow it. All library macro definitions are assumed to have 
normal output format. If the ICTL appears before the START card and it is incorrect, the 
assembly is terminated. When an ICTL appears out of sequence (must be first card 
following START card), the ICTL terminates the assembly. 
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Examples: 
LABEL AOPERATIONA OPERAND 
1 10 16 
1. ICTL 2,79,18 
2. ICTL 2,,16 


1. Coding is to follow a new format by starting in column 2, ending in column 79, and 
continuing on the following line in column 10. 


2. Coding is to follow standard format except that it is to start in column 2. 
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21.2. INPUT SEQUENCE CONTROL (ISEQ) 


The input sequence control (ISEQ) directive informs the assembler which columns of the 
source statement contain the field used for checking the sequence of statements and 
controls the initiation and termination of sequence checking. The format of the ISEQ 
directive is: 





A OPERATION A OPERAND 


where: 


Is a decimal integer specifying the left-most column of the field to be used for the 
sequence check. 


Is a decimal integer specifying the right-most column of the field to be used for the 
sequence check; r must be greater than or equal to |. 


Columns to be checked should not fall between the beginning and ending input columns 
specified for the program. 


The sequence check begins with the first source statement after the first ISEQ directive and 
is terminated by an ISEQ directive with a blank or invalid operand field. 


Sequence checking is not performed on statements generated from macro definitions or on 
statements inserted into the source code via a COPY directive. 


If no ISEQ directive is supplied, no sequence checking occurs. 


Example: 
LABEL AOPERAT 1ONA OPERAND 
1 10 16 


ISEQ 75,79 


Input record sequence is to be checked using the sequence numbers found in columns 
75 through 79. 
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21.3. REPRODUCE FOLLOWING RECORD (REPRO) 


The reproduce following record (REPRO) directive is used to reproduce a record in its 
entirety (columns 1 through 80) during assembly time. This directive is used to produce 
statements to precede or succeed the object module and eliminates the necessity of 
manually inserting them. The format of the REPRO directive is: 





AOPERATION A OPERAND 


This directive causes the contents of the following source record to be reproduced as a 
record in the assembler output. Each REPRO directive produces one record; up to 80 bytes 
are reproduced. 


A REPRO directive prior to the first control section of the program produces records prior to 
the first control section. 


All REPRO directives following the declaration of the first CSECT (START) produce records 
which appear after the object module transfer record. Although this directive may be 
included anywhere in the program, it cannot be used before a macro definition. 


No substitution for variable symbols occurs in the record thus produced. 


Example: 
LABEL AOPERAT IONA OPERAND 
1 10 16 





REPRO 
INCLUDE XYZ,USERLIB 


START g 


END BEGIN 
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21.4. PRODUCE A RECORD (PUNCH) 


The produce a record (PUNCH) directive produces a record at assembly time. This directive is 
used to produce job control card images to precede or succeed the object module; it 
eliminates the necessity of manually inserting them. The format of the PUNCH directive is: 








A OPERATION A OPERAND 


unused 


where: 
Cy,.+-,Cgo 
Represents a string of up to 80 characters produced as a record in the object code 
output. 


The following conditions apply to the characters specified in the operand field: 

7 Up to 80 characters, including spaces, may be specified within the apostrophes. 
= An apostrophe within the operand must be specified as a pair of apostrophes. 
= An ampersand within the operand must be specified as a pair of ampersands. 
= Spaces must be used to separate fields. 


a In counting characters for the limit of 80, a pair of apostrophes or ampersands written 
to express a single apostrophe or ampersand counts as one character. 


A PUNCH directive prior to the first control section of the program produces records prior to 
the first control section, and all others produce records after the last control section. 


Although this directive may be included anywhere in the program, it cannot be used before 
a macro definition. 


Variable symbol substitution is performed within the operand field. 


Example: 
LABEL AOPERATIONA OPERAND 
1 10 16 
PUNCH "INCLUDE XYZ,USERLIB! 


The record XYZ is included from USERL/B at assembly time. 
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21.5. INCLUDE CODE FROM A LIBRARY (COPY) 


The include code from a library (COPY) directive causes the source module identified in the 
operand field of the COPY directive to be included directly into the source program being 
assembled. The format of the COPY directive is: 







A OPERATION A OPERAND 


unused 


where: 
symbol 
Identifies the source module to be copied by the assembler. Only one symbol may 
be used. 


The assembler places the source code, identified by the operand, immediately after the 
COPY directive. This source module may not include any COPY, END, ICTL, MACRO, or 
MEND directives. The last statement in the source module may not be continued into the 
source program being assembled. Statements included in the program by a COPY directive 
are assumed to be in standard format regardless of any ICTL directives in the program. 


Example: 
LABEL AOPERATIONAS OPERAND 
| 10 16 


a RT ES SN ne 


COPY SUBRUT 


SUBRUT is copied from a source library and placed into the calling program. 
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21.6. CHANNEL COMMAND WORD (CCW) 


The channel command word (CCW) defines an 8-byte field aligned on a double word 
boundary and is located in main storage. The CCW is used to initiate |/O operations such 
as reading and writing. It has four operands which specify the contents of the channel 
command word. Each operand is separated by a comma and all four operands must appear 
in the operand field. 


Format: 






A OPERATION A OPERAND 






[symbol] OP, OP, OP, OP, 


where: 


Op, 
Is an absolute expression that specifies the command code. The command code 
defines the |/O operation to be performed. This value is right-justified in byte 1. 


OPp2 
Is an expression that specifies the address of the first byte of data in main storage 
to be controlled. This value is located in bits 13 through 31. Bits 8 through 12 are 
set to zero. 


Op3 
Is an absolute expression that specifies the flags for bits 33 and 34, and zeros for 
bits 32 and 35 through 47. Flag bits are set if a specific option is being used. 


Op, 
Is an absolute expression representing the byte count which specifies the number 
of bytes to be controlled. This value is right justified in bytes 7 and 8. 
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Operational Considerations: 


= ~=sIf a symbol is used in the label field, it references the address of the leftmost byte of 
the CCW. Its length attribute is eight. 


= All four operands must be specified. 


= For more detailed information on the use of the CCW, see the processor programmer 
reference manual, UP-8052 (current version). 


Example: 
LABEL AOPERATIONA OPE RAND 
| 10 16 
CCW 2, INAREA,X'80' ,8¢ 
ccwl CCW X'G3' ,LOC+24,X'98' 55 


CCW 5 ,8,X'GO',128 























PART 5. BAL MACROS 
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22. Macro Facility 


22.1. THE MACRO PROCESSOR 


The OS/3 macro facility processes macro call instructions. This macro processor functions 
somewhat like a compiler and provides BAL users with a higher level basic assembler 
language. The OS/3 macro call instructions that make up this language are stored in the 
macro library file (SYSMAC). Each macro call instruction provided by Sperry Univac (data 
management, sort/merge, etc.) generates an open subroutine each time it is used in a 
program. An open subroutine is a set of BAL source instructions, designed to perform a 
particular function, that must be inserted into a program at each place desired. (The set of 
BAL instructions that make up an open subroutine is also called inline expansion code}. The 
macro facility expands the OS/3 macro definitions from $YSMAC and inserts them into a 
program in place of a macro call instruction. 


Although the macro processor is far from being a high-level language compiler like COBOL 
or FORTRAN, it has language statements that must be interpreted and reduced to machine 
instructions just like any compiler. We no longer have an assembler that just converts one 
source instruction to one machine instruction. We now have an assembler that accepts one 
source statement in the form of a macro call instruction and converts this one statement 
into as many BAL source instructions as required to perform the particular function. 


The macro processor is a valuable tool for the BAL programmer. Any programmer who 
writes his programs in assembly language quickly discovers the existence of macro 
instructions (colloquially known as macros). Most programmers use data management 
macros to define their files (DTFs) and to process them (OPEN, GET, PUT, etc). These macros 
were created for a specific reason. For example, to open a file might take 15 instructions in 
a particular sequence. If you want to open five files, you have to code this 15-instruction 
sequence five times. The only differences in these instructions that you would have to code 
would be the instruction parameters that generally vary from file to file. To avoid this boring 
and repetitive process, which also provides opportunity for making coding errors, data 
management macro instructions are provided for your use to define and process the 
necessary instruction sequences. These sequences are known to be error free, and you can 
generate your specific instruction sequences merely by filling in parameters in two or three 
lines of coding. 


lf you are an_ experienced BAL programmer, you’ should be familiar with 
macroprogramming because, to write any type of worthwhile BAL program, you have to 
use data management macro instructions. This means you've studied the data 
management instructions, and possibly others, and used them when writing BAL 
programs. You know what inline expansion code looks like because you are a user of 
macro calls and have seen inline code in your source listings. 








UP-8061 Rev. 3 SPERRY UNIVAC OS/3 22-2 
ASSEMBLER 


For instance, look at the listing shown in Figure 22-1. This program has five macro call 
instructions, and the inline code that immediately follows each call instruction is marked 
with a plus sign. The inline code shown in this listing is generated via macro call 
instructions designed by Sperry Univac. Each call is designed to produce a sequence of 
source instructions that will perform a specific function. The DTFPR macro instruction, 
shown in Figure 22-1, is designed to generate all the DC statements required to define a 
printer file for data management. If a DTFPR didn’t exist, you would have to code all the 
DC statements needed to create a printer file. The purpose of this part of the user guide is 
to teach you how to become more proficient at using macro call instructions. We are going 
to teach you how to design your own macros, not how to call macros. You can learn about 
the macro instructions Sperry Univac provides by reading the related user guides. If you 
are experienced in macro design, you would be better off referring to the assembler 
programmer reference, UP-8227 (current version), and not this user guide because the 
discussion in this part is meant for novice macro designers. 


LOC. OBYECT CODE ADORI AOOR2 LINE SOUR CE STATEMENT 
a900000 1 START O 
goaooa cséa0 2 BEGIN BALR 6,0 
fahekelole 4 3 USING %,6 
goodg2 OC06 60E6 60ED OOOES DOOEF 4 EXAMPLE TR INDEX» TABLE 
000008 DDO& 60E6 60ED OOOES8 GOOEF S EXAMPLE2 TRT INDEX, TABLE MA R 0 
oe 
ooogoge aroc T+ CNOP O44 C 0 INSTRUCT N 
OCO0IO 4510 6016 00018 8 BaL 35**f482) 
oadol4 480 ge oc x*eo° 
000015 codd4d 10+ oc aL 3(ouTs 
Qg00018 GA26 lle SVC 38 Issue Svc 
GOCOIA 0206 6312 60E6 OO114 GOOES 12 MVC BUF (7B, INDEX 
(sro our 
oooa2o 14% oc Gyvegl SET ALIGNMENT 
000020 S830 6126 a0128 rS¢ t 2,=ACOUT§ LOAD RISe FILENAME ADDRESS 
000024 9220 1031 00031 16+ MVI 9019sxX*°20° SET FUNCTION CODE 
agog28 SarFo 1034 00034 17° L 15,520,1) LOAD ADOR OF COMMON 17/0 
ogoog2c OSEF 18¢ BALR 34,15 LINK TO COMMON 
Goac2E 20+ ac ayeol 
Qooaze S830 6126 00128 2i+ L T,=A(OUT) LOAD RIS, FILENAME ADORESS 
Qo00032 OA27 22¢ SVC 39 ISSUE SVC 
000034 24 os GH 
25%8 
26e8 THE DUMP PARAMETER IS A 1-4 BYTE HEX CODE TO BE OISPLAYED BY DUMP 
2itee 
000034 1731 28+ XR 1,] CLEAR DUMP INDICATOR 
000036 3700 29% XR 0,0 CLEAR DUMP CODE 
000038 GAIB 30+ svc 27 DUMP SVC 
324% OTFPR EXECIS 12/39774 
ooog3A C7O007TCORGTOO 33+ CNOP €,8 DOUBLE WORD BOUNDARY ALIGNMENT 
000080 34*0uUT EQU * 
35* ENTRY Out 
go0coso coocdocoondccaoco 36+ oc 7F*O* 
Ooo0sSc OeEsSEs4040404a0 37+ oc CLI*OQUT* OCSNME 
000063 40 38+ oc cLire * 
ooode* ogoo 39% oc H*O* OPSMFLG 
600066 o000 40 Oc H*O* OPSPUB 
41 *,PRAD NOT SPECIFIED. STANOARD LINE ADVANCE SET TO 1. 
42 #,RECORD FORMAT KEYWORD NOT SPECIFIED. SET TO FIXUNB. 
oo0gd6s coocccoo 43+ oc a(ci DPSPOV 
ooago6ec acca age oc H*O* DPSRLA 
QoGg6E o4FO a+ oc XL2°O4FO* DOPSDTF 
oooa7a0 Fa 46¢ oc cL3*a* 
o00071 Ga 4Te oc XL2°00* OPSREQS 
aooog72 48*OUTC EQu * ERROR FLAG LABEL 
age ENTRY CUTC 
acaco72 cooa soe oc H°C* DPSEFG 


Figure 22—1. Example of Inline Macro Expansion (Part 1 of 2) 
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LOC. OBJECT CODE ADORI AODDR2 LINE SOURCE STATEMENT 

000074 oococaco Sl oc a¢DPscomO) Opsrocs 

S2¢ EXTRN DPSCOMO 

53 3,NO ERROR ROUTINE. ERRORS RETURN INLINE 
agooo7e cocoaooa S4e oc At} DPSERR 
gooorc aa 556 Oc HLI*O* OPSCHIC 
gaco7p ooor14 S64 oc ALJ{BUF} DPSCWwID 

ST+ EXTRN BUF 
Ooogso oo0c S8e oc hH*O* OPSCWI1F 
900082 acoOo 59% oc H*o® DPSCWIB 
oo00s4 00 604 oc HLi*%o* DPSREC 
goacss co 61+ oc YL3¢0) OPSIRG 
gpocoss o4 62+ oc YLrC4s OPSFGy 
ooocs? 00 63% oc YL2ItQ) OPSFG2 
000088 40 64+ oc YL1¢64! OPSFG3 
oaoge9 co oS+ oc YLICOH OPSF GS 
oood6a 00 66+ oc YLICO¥ OPSFGS 
goose o4 67? oc YL3 C4) OPSRFM 
oooocsc aoio 68+ oc H*olé* OPSBKS 
oo00ose co 69+ oc YLICG? OPSCCS 
ooogsr c9 70+ oc YLE¢9} DPSPRA 
g00aq9q acaocdacG V+ oc 4tab DPSBAS 
go0094 caoocoad T2+ oc AUSAVE, OPSSay 

73+ EXTRN SAVE 
000098 cooGoooG THe “GC ACOs DPSSAVR 
oa o009c 75 Os F 
aooogao 76 SAVE os CLI2 
Oo0oEs c410000COFQBE4 7? INDEX oc x*C410GO0COFOB04* 
QOOOGEF CIC2C3C4HCSCOCTCE 78 TABLE oc CLI6*ABCDEF GHIJKLMNOP* 
OOOOFF FQOFOFOF OF OF 00809 79 oc CL 26 *OOGGOOQRST UV WX ¥Z* 
000316 80 os F 
oo0oll4 81 BUF os ZL16 
oacooo 82 Eno BEGIN 
oook28 cooocdso 83 =ACOUTD 


Figure 22—1. Example of Inline Macro Expansion (Part 2 of 2) 


22.2. MACRO SOURCE CODE 


Although you've probably seen a lot of inline expansion code, chances are you have 
probably never seen macro source code. Inline expansion code originates from macro 
source code. Whenever you use an OS/3 macro call instruction, the macro facility retrieves 
the macro source code from $Y$MAC, which contains a macro definition for each macro call 
instruction provided by Sperry Univac. Each macro definition holds the BAL source 
instructions that are to be generated inline. If you have a BAL program that has become 
popular and is recurring in other programs and you want to make this code available via a 
macro call instruction, you have to design a macro definition. You use the statements 
provided with the assembler macro faciity to transform your BAL program into a macro 
definition. It is the responsibility of the macro facility, which is part of the assembler, to 
process your macro definition. The macro facility works entirely with macro source code 
while a conventional assembly recognizes and processes program source code. Macro 
source code consists of macro facility source statements and BAL source statements. 


There are three types of source code that are always associated with the macro facility: 
1. Macro source code 
2. Macro call instruction 


3. Inline expansion code 
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The order in which these different types of source code are listed is the order of their 
evolution. First, you must have a macro definition (macro source code) before you can use a 
macro Call instruction to generate inline expansion code. An important fact to keep in mind 
is that all of this code is source code. The macro facility works entirely at the source code 
level, from the macro call instruction, to the $Y$MAC, to the inline expansion code. The 
following diagram shows the interactions of each type of code when a macro call instruction 
is used. 


PROGRAM SOURCE CODE MACRO SOURCE CODE 


START 0 
BALR-~ 6,0 
USING *,6 


macro call instruction 


macro definition 


inline expansion code 
macro definition 


LA 13,SAVE 
END BEGIN 


The macro facility performs preassemble processing. It has nothing to do with turning 
source code into object code. The basic function of the macro facility is to search for the 
proper macro definition when a macro call instruction is used in a program, and generate 
the requested inline expansion code. This is done before the assembler starts creating an 
object module. When the assembler detects a pseudo-operation code (a mnemonic code that 
is not a machine instruction), that code is turned over to the macro facility. Each macro 
definition has a unique ca//-name that is identified in the operation field of the macro call 
instruction. The macro facility searches for the macro definition that matches the ca//-name 
and generates the requested inline expansion code. The macro facility expands the code 
inline before the assembler starts converting the program source code to object code. 


The macro facility has capabilities other than just inserting the BAL source instructions that 
are contained inside a macro definition inline in place of the macro call instruction. There 
are other elements of the expansion that you can control. You can use the macro facility to 
perform variable parameter replacement and variable inline expansion code. if you've used 
macro call instructions supplied by Sperry Univac, then you are familiar with positional and 
keyword parameters. The values you code as positional or keyword parameters in the call 
instruction replace variable symbols coded in the macro definition. Using variable parameter 
replacement, you can use the values given in the call instruction to replace variable symbols 
coded in the /abel. operation, or operand field of any BAL instruction in the macro definition. 


Variable inline expansion code is another level of control that allows you to design a macro 
definition that will vary the pattern of BAL instructions generated from within the macro 
definition. Conditional assembly language statements are used to design the logic for 
variable inline expansion code. Variable parameter replacement and variable inline 
expansion code allow you to give the user of your macro cail instruction more control over 
the code that is generated. If you use these coding techniques when designing macro 
definitions, the user can control calculations performed by the open subroutine and select 
the functions that are to be performed. 
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23. Macro Design 


23.1. THE MACRO DEFINITION 


You can define your own macro call instructions by using the statements provided with the 
assembler macro facility. When you define a call, it must be in a formalized pattern called a 
macro definition. Each macro definition is organized into the following parts: 


HEADING 






TRAILER 


The two major areas to consider when designing a macro definition are the heading and the 
body; the trailer is merely a single statement indicating the end of the macro definition. The 
heading is always the first part of the macro, and it consists of statements you use to design 
the macro call instruction. The body, which immediately follows the heading, is where you 
design the inline expansion code. Model statements are used in the body to construct a 
model of the inline expansion code you want generated by the macro call instruction. If 
you design a basic macro definition, the model statements are merely a copy of the BAL 
source instructions that are to be expanded inline. A basic macro definition is one that does 
not require any parameters from the macro call instruction and will generate the same 
sequence of source instructions, with no modifications, each time it is called. The following 
diagram shows the operation of a basic macro definition. 
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MACRO DEFINITION MACRO CALL !NSTRUCTION 


HEADING ADD1 


L 13,PAY INLINE EXPANSION CODE 
A 13,RAISE 


ST 13, TOTAL 


TRAILER 






















L 13,PAY 
A 13,RAISE 
ST 13, TOTAL 





The only real design consideration for the basic macro definition is the ca/l-name, which is 
the mnemonic that appears in the operation field of the macro call instruction. You must 
give the ca//-name in the heading. 


lf you want variable parameter replacement in the body, you must give further 
consideration to coding the heading and body. Variable parameter substitution is 
substituting parameter values coded in the macro call instruction in place of arguments 
given in the /abel, operation, or operand fields of model statements. The following diagram 
shows the operation of a macro definition designed to perform parameter substitution. 


MACRO DEFINITION MACRO CALL INSTRUCTION 


HEADING ADD2 450,40, TOTAL 


L 13,=F’argument’ e SE 
A 13,=F’argument’ INLINE EXPANSION C 


ST 13,argument 


TRAILER 
















L—-13,=F’450" 
A 13,=F'40° 
ST 13, TOTAL 









You must design the body to indicate where the arguments are and design the heading to 
indicate how the parameter values are to be coded in the macro call instruction and how the 
body is to reference the parameter values in the macro call instruction. 


If you want variable inline expansion code, you must include model statements other than 
the BAL source statements that you want expanded inline. These other model statements 
are called conditional assembly language statements, and they enable you to vary the 
pattern of the inline expansion code produced by the macro definition. The pattern of code 
generated depends on a value given in the macro call instruction. The following diagram 
shows the operation of a macro definition designed to perform variable inline expansion 
code. 
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MACRO DEFINITION MACRO CALL INSTRUCTION 1 


HEADING PAY1 530,1,SAVE=TOTAL 


Ls 13,=F’argument’ 
advance to STORE if P2=1 MACRO CALL INSTRUCTION 2 


A 13,=F’argument’ 
STORE ST 13,argument 


TRAILER 




















PAY1 530, 2,SAVE=TOTAL,RAISE=40 









INLINE EXPANSION CODE 1 












L 13,=F’530’ 
ST 13, TOTAL 


INLINE EXPANSION CODE 2 


13,=F'530’ 
A 13,=F’40' 
13, TOTAL 


Parameter 2 in the call indicates which pattern of inline expansion code is to be 
generated. The second statement in the body is a conditional assembly that tests the value 
of parameter 2. If the value of parameter 2 is 1, then a branch is made to STORE and the 
A instruction is not included in the inline expansion code. If the value of parameter 2 is 2, 
no branch is made and all of the instructions are generated. 


23.2. MACRO DEFINITION STORAGE 


After you've designed a macro definition there are several things you can do with it. If it is 
for your program and not to be used by anyone else, you can put it in your source program 
when it is assembled. A macro definition is placed in the source program immediately 
following the start-of-data (/$) job control statement and before the START assembler 
directive (Figure 23-1). The macro definition is stored in the temporary job run library file 
(SYSRUN), and it is only available during execution of the current job. To make a macro 
definition available to anyone at anytime, it must be stored in a library other than $SY$RUN 
(either SYSMAC or your own library). Figure 23-2 shows how a macro definition is 
obtained from $Y$MAC. To add a macro definition from cards to a disk file, you can use 
the ELE librarian control statement. (For more information on the system library and 
creating library files, see the system service programs (SSP) user guide, UP-8062 (current 
version)). Whether a macro definition is stored in a library or is part of a source program 
depends on whether you want the macro to be temporary or permanent. 


SOURCE DECK SYSRES DISK PACK 













$YSRUN 

BEFORE INLINE EXPANSION 
OF 

STORE 









p1,p2,p3,p4 
L p1,p2 
A p1,p3 
pi,p4 








0 
BALR 6,0 
USING *6 
5,RAG,BAG,SAG 


BAL PROGRAM SOURCE CODE 




























START O 
MACRO DEFINITION 
STORE is the name 


// JOB CALLMAC,,5C00 





$Y$LOD 


OS/3 ASSEMBLER 
WITH 
MACRO FACILITY 










$Y$RUN 

AFTER INLINE EXPANSION 
OF 

STORE 













P1,p2,p3,p4 
t p1,p2 
A P1,p3 
p1,p4 






5,RAG,BAG,SAG 

L 5,RAG 
{ A 5,BAG 
5,SAG 


Figure 23—1. Accessing a Macro Definition Submitted in the Source Deck 











Yya1aWASsSV 
£/SO OVAINN AddadS 
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SOURCE DECK SYSRES DISK PACK 





$Y$RUN 
BEFORE INLINE EXPANSION 
OF 
STORE 


START 0 

BALR 6,0 

USING *6 

STORE 5,RAG,BAG,SAG 





END BEGIN 


BAL PROGRAM SOURCE CODE 






$Y$RUN 
AFTER INLINE EXPANSION 
OF 
STORE 


// JOB CALLMAC,,5C00 










0 

6,0 

*6 
5,RAG,BAG,SAG 





Figure 23—2. Accessing a Macro Definition Stored in a Library 
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23.3. THE MACRO CALL INSTRUCTION 


The macro call instruction has two functions: to call a macro definition and to pass 
parameters to the macro definition, if required. The /abe/ and operand fields of the macro 


call instructions are used for passing parameters, and the operation field is used to call the 
macro definition: 






A OPERATION A OPERAND 








[symbol] call-name 


[py Pz ,---Po50] 


Just as the inline expansion code originates from the macro definition body, the macro call 
instruction originates from the heading. The contents of the /abe/l, operation, and operand 
fields of the macro call instruction are specified in the heading of the macro definition. 
You actually use the heading of the macro definition as a dummy call line to design the 
format of the macro call instruction. The following diagram shows an_ abstract 
representation of how the heading represents each field of the macro call instruction. (The 
fields shown in the diagram of the heading do not necessarily appear exactly where they 
are shown; the diagram is provided to illustrate the association the heading has with the 
call; the exact format of the heading is described in the following discussion.) 


| eymbot | cattname | peer 


label Patan Parameter 
HEADING argument specifications 


MACRO 
DEFINITION 
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Everything you want the user to code in the macro call instruction must be represented in 
the heading. If you design a basic macro definition, the only thing that you require from the 
macro call instruction is the ca//-name in the operation field. The ca//-name that you want 
the user to use to call your basic macro definition is duplicated in the heading. All ca//- 
names: 


1. Must begin with an alphabetic character or special letter. 
2. Must not exceed eight characters in length. 
3. Must not contain embedded blanks or other special characters. 


4. Must not be the same name as any of the Sperry Univac mnemonic operation codes or 
any mnemonic operation codes you have in your library. This restriction is normally 
true unless you use the OPSYM directive to override a valid mnemonic code (16.2). 


A macro definition that is designed to perform variable parameter replacement must 
indicate, in the heading, the type and number of parameters to expect from the macro call 
instruction. Values may be passed to the macro definition from the /abe/ field or the operand 
field of a macro call instruction. If you want to use the symbol in the /abe/ field of a call 
instruction, you must have a /abe/-argument in the heading. Before the macro definition can 
pick up the values from the parameter-list in the macro call instruction, they must be coded 
according to the parameter-specifications given in the heading. You use the heading to 
specify how many parameters are to be coded in the macro call instruction and whether the 
parameters are keyword or positional, or both. The macro call instruction must be coded in 
accordance with the heading before the values in the parameter-list can properly replace 
the arguments in the body. 


The heading can specify a parameter-list of up to 252 parameters. All parameters must be 
separated by commas and each parameter can be from O to 127 characters in length. In 
order to be properly picked up by the macro definition, the string of characters comprising 
a macro instruction operand must satisfy the following conditions: 


= May include one or more sequences of characters enclosed in single apostrophes. The 
apostrophes enclosing each character sequence are paired. Paired apostrophes may 
appear within paired apostrophes. 


a May include a single apostrophe outside paired apostrophes if written as part of the 
following sequence: any special character except an ampersand, the letter L, an 
apostrophe, and a letter. 


= May include an ampersand as the first character of a variable symbol if the ampersand 
is a single ampersand or the last ampersand of a string containing an odd number of 
ampersands. 


s May include paired parentheses outside paired apostrophes. To determine pairing, a 
left parenthesis is paired with the immediately following right parenthesis (that is, no 
parentheses between them). Additional pairs are determined by ignoring the first pair 
and reapplying the rule. 
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= May include an equal sign only as the first character of an operand or within paired 
parentheses or paired apostrophes. 


= = =May include a comma as a character in a string if the comma is enclosed in paired 
parentheses or paired apostrophes. A comma standing alone is interpreted as the end 
of an operand. 


# May include a blank within paired apostrophes. A blank not enclosed in apostrophes 
terminates the operand field. 


NOTE: 


Operands can be coded on more than one line through the use of a continuation character 
in column 72. If a line is to be continued, the last operand on that line must be followed 
by a comma. A warning message is issued if a comma is not included. 


The specifications for the parameter-list of a macro call instruction should be thoroughly 
documented for the user of the macro. He should know the range of values each parameter 
is to have and the type of parameters. 


There are two ways the macro definition can recognize values in the parameter-/ist: by the 
position of the value in the list or by the name associated with the value in the list. A value 
identified by the position it holds in the list is called a positional parameter, and one that is 
identified by a name is called a keyword parameter. When the parameter specifications in 
the heading indicate that the parameter-list is to contain only positional parameters, the 
corresponding values in the operand field of the macro call instruction must appear in the 
same operands each time the call is used. If any positional parameters are omitted in the 
call, this omission must be indicated by retaining the comma in the parameter’s place. For 
instance, if a macro has the capacity to accept four positional parameters, the call doesn’t 
necessarily have to give all the parameters because some of the parameters may be optional 
to the macro’s function. The proper coding of some of the possible combinations for four 
positional parameters is: 


LABEL AOPERATIONA OPERAND 
] 10 16 

NAME | CALL P1,P2,P3,P4 

NAME2 CALL »P2,P3,P4 

NAME 3 CALL P1,,P3,P4 

NAME 4 CALL P1,P2,,P4 

NAMES CALL P},P2,P3, 

NAME6 CALL PI,,,P4 

NAME7 CALL P] 


It is not necessary to retain the commas for trailing positional parameters; if you are not 
going to code any of the remaining positional parameters in a call line, you do not have to 
code the commas for those parameters. But it doesn’t matter if you do code the commas. | 
could have left out the last comma for CALL in NAME5 or | could have left the commas in 
for CALL in NAME7. 
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The following are typical examples of positional parameters with their calls: 


OPEN INFILE 
READIN GET INFILE,WORK] 
WRIT] PUT PRINTER,HEDR 
ENDIN CLOSE INFILE 
ACTION OPR TEXT,,,REPLY,AREA 


Keyword parameters, unlike positional parameters, are not referenced by the position they 
hold in the call line but by the name of the keyword in the call line. A keyword parameter 
consists of three parts: a keyword, an equal sign, and a value: 


keyword=value 


The keyword is an alphanumeric string from one to seven characters in length. Actually, a 
keyword may be longer than six, but the macro facility recognizes only the first seven 
characters as the true name and truncates the remaining characters. The value is 
dependent upon the arguments in the macro. 


Keyword parameters, like positional parameters, must be separated by commas but aren't 
restricted to being in the same position each time they are coded. This nonpositional 
characteristic eliminates the inconvenience of comma counting because keyword 
parameters can be coded in any order and, when a keyword is omitted, a comma does not 
have to be retained in the parameter’s place. Keyword parameters also provide another 
coding choice: default values for omitted parameters. The macro may be designed to 
automatically provide a preselected value for a keyword parameter that is omitted from a 
call line. To illustrate, suppose we had a keyword parameter called CHOICE. This parameter 
could be assigned optional values, such as ONE, NONE, or ALL. We could then write the 
parameter in the macro with a default value equal to ALL. Now when we call the macro, the 
ALL option is used unless the call specifically states another parameter such as 
CHOICE=ONE or CHOICE=NONE. This is true even if we omit the keyword parameter in the 
call. However, if a keyword is not given a default value within a macro and it is omitted in 
the call, it receives the value of a null character string. 


Following are examples of typical macros with keyword parameters: 


LABEL A OPERATION A OPERAND 
TAPOUT TYPE=OUTPUT,FLBL=STD,RCFM=FIXBLK, 
BKSZ=2200,RCSZ=220,IOA1=TAPAREA, 
WORK=YES 
PRINTR RCFM=FIXED,BKSZ=132,10A1=LIST WORK=YES, 


PRAD=2,PRTOV=YES,ERROR=RECOVR 
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Both positional and keyword parameters may appear in the same call line. This is known as 
a mixed-mode macro call. In a mixed mode macro call, the positional parameter string must 
be coded before the keyword parameter string: 






A OPERATION A OPERAND 






[symbol] call-name 


Positional and keyword parameters may have a subordinate list of parameters called 
subparameters. This sublist of parameters permits the macro call line to provide more than 


one value in a single parameter position. A sublist for positional parameters is coded as 
follows: 


LABEL A OPERATION A OPERAND 


[symbol] call-name (p, Py geP yn VrevelDy 4 Py in) 





A sublist for keyword parameters is coded as follows: 






A OPERATION A OPERAND 






[symbol] call-name 


k, =(p, reD, ) wk, =(P, ee 


The parameter sublist must always be enclosed by parentheses, and the subparameters are 
coded as positional parameters (parameter omission is indicated by retaining commas). 


When you design a macro definition that requires parameters from the macro call 
instruction, the heading is the means to pass values from the call to the body. There are 
two methods available for designing the call-to-heading-to-body communications cycle that 
generates inline expansion code. You can use a macro definition in PROC format or a 
macro definition in MACRO format. Each uses a different technique in the heading for 
designing the call instruction. If a SET symbol appears in the operand entry of a macro 


instruction, attribute information is not provided and the operand may not be accessed as 
a sublist. 
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24. Two Types of Macro Definitions 


24.1. PROCS AND MACROS 


The OS/3 macro facility can process two types of macro definitions. One type is called a 
procedure (PROC) and has been the standard type of macro definition for Sperry Univac 
systems for many years. The other type is called a macro (MACRO) and is available primarily 
to be compatible with the IBM 360/20 system. You can design a macro definition in PROC 
format or MACRO format; the OS/3 macro facility will accept and process either one. 
Although the statements inside a PROC are a little different from those inside a MACRO, 
both types of definitions will always have a heading, a body, and a trailer and will always be 
in that order. Actually, the only differences between the two types of definitions occur in the 
heading and the trailer. The body which contains the model statements, is the same for both 
PROCs and MACROs. Let's take a look at a macro definition heading in MACRO format and 
compare it to the same macro definition heading in PROC format and discuss their 
differences without going into a lot of detail about the operation of each. Look at Figure 
24—1 and you'll see the differences between the headings for the PROC and the MACRO. 


PROC HEADING 


LABEL A OPERATION A OPERAND 


MACRO HEADING 


LABEL A OPERATION A OPERAND 


CALL INSTRUCTION 


LABEL A OPERATION A OPERAND 


Figure 24—1. PROC and MACRO Heading 






PROC STATEMENT 


NAME STATEMENT 












MACRO STATEMENT 


PROTOTYPE STATEMENT 
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24.2. CALL INSTRUCTION DESIGN 


Even through the format for the PROC and MACRO headings is different, it doesn’t affect 
the coding rules for the call instruction format. When a user issues a call instruction, he is 
completely unaware of whether the call communicates with a PROC or MACRO. This is 
because both headings have the same counterpart fields that represent each field of the 
call. The /abel-argument in each heading represents the symbo/ in the label field of the call 
instruction, the ca//-name in each heading is the ca//-name used in the call instruction, and 
the parameter-specifications in each heading define the specifications for the parameter-list 
in the call. The fields representing the call instruction are in different positions in the 
heading for the PROC and MACRO, but they serve the same function for each. 


Variable symbols are used to create the label-argument and parameter-specifications in 
the PROC and MACRO heading. The variable symbol is a macro language symbol used as 
a dummy argument in a macro definition. It’s a dummy argument because the variable 
symbol will be replaced with a value when the macro definition is called by the macro call 
instruction. Since a variable symbol is recognized and processed only by the macro facility, 
it is distinct from the symbols used in program source code. The macro facility requires 
that any symbol to be used as a variable symbol must have an ampersand (&) as an 
identifier in the first character position. There are seven character positions after the 
ampersand that are used to construct the variable symbol. Because a variable symbol must 
always be identified with an ampersand in the first character position, a variable symbol 
will always be at least two characters in length (an ampersand and a character) and eight 
characters at the most (an ampersand and seven characters). The character position after 
the ampersand can contain a letter (A through Z) or a special letter (?$#@) and each of the 
remaining seven positions can contain a letter, special character (see 2.4 for character 
types), or a digit (O through 9): 


? 
$ letter letter 

# special character 8 special character 
@ digit digit 

A thru Z 


& 


Some examples of legal variable symbols are: 


&ABCDEFG 
&#BCDE67 
&$6 
&@ 


illegal variable symbols: 


ABCDEFGHI 
&&CDEFGHI 
&=KEY 
&95&95 

& 
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When variable symbols are used, the following restrictions must be considered: 


= A variable symbol may not be used to generate a new sequence symbol, a SET symbol, 
a parameter, or a system variable symbol. 


= A variable symbol may not be used in the label or operand field of an END, ICTL, ISEQ, 
COPY, or PRINT directive. 


= A variable symbol may not be used in the operation field of a statement. 
= No variable symbol replacement is performed on the line following a REPRO directive. 


= Variable symbol replacement must not produce leading blanks in the label or operand 
fields. 


The OS/3 assembler provides system variable symbols. When a system variable symbol is 
used in a model statement, a value is automatically provided by the macro facility. The 
system variable symbols available with the macro facility are given in Appendix G. 


Both the PROC and the MACRO use two statements in the heading; the PROC may have 
more than two but must have at least two. When designing a MACRO, you use the first 
statement strictly for indicating MACRO format; the entire second statement, called the 
prototype statement, is used to design the call instruction. In a PROC, the first statement is 
not only used to indicate a PROC format but is also used, along with the second statement, 
for call instruction design. The heading of the PROC consists of the PROC and NAME 
statement, and the heading of a macro consists of a MACRO and prototype statement. 


In MACRO format, each field of the prototype statement is used for designing each 
corresponding field in the macro call instruction. If you want to reference the /abe/ field in 
the call instruction, you must indicate a variable symbol for the /abe/-argument in the /abel 
field of the prototype statement. The ca//-name for the call instruction is indicated in the 
operation field of the prototype statement, and the parameter-specifications for the 
parameter-list to be coded in the call instruction are indicated by variable symbols in the 
operand field of the prototype statement. The variable symbols for indicating a /abel- 
argument and for specifying positional and keyword parameters are coded in the prototype 
statement as follows: 


PROC 
STATEMENT 


PROC &pos,m, &key=,,..,8key = 





CALL 
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If you want the call instruction to pass values as positional parameters, variable symbols 
representing these positional parameters are coded starting in operand 1 of the prototype 
statement and are separated by commas. Each positional parameter is represented by a 
unique variable symbol that must be coded in the prototype statement in the same position 
its corresponding values are to be coded in the operand field of the call. If you want a mixed- 
mode call instruction, you must code variable symbols representing the keyword parameters 
immediately following the variable symbols for positional parameters. The format of the 
keyword parameter variable symbol is: 


&key= 


where key is a 1- to 6-character keyword to be used in the call. The keyword in the call may 
be longer than six characters, but the macro facility will only use the first six characters as 
the keyword name. If you want the call to pass values using only keyword parameters, then 
you code only keyword parameter variable symbols starting in operand 1 of the prototype 
statement. When designing a call instruction from a prototype statement, you can match 
each field fo the statement with each field of the call, and you can also match value in the 
parameter-list of the call with each variable symbol in the operand field of the prototype 
statement. The prototype statement is the dummy call instruction used for designing the 
macro call instruction. 


Even though you can compare the prototype statement with the call instruction on a field- 
by-field basis, you cannot use a single statement in the PROC heading for a similar 
comparison. This is because you must use both the PROC and the NAME statement to 
design the call instruction. The /abe/ field of the PROC statement is used to indicate the 
variable symbol for referencing the symbol in the /abe/ field of the call instruction, and the 
operand field of the PROC statement is used to indicate the variable symbols used for 
referencing the parameter-list in the operand field of the call. The coding of parameter- 
specifications in the operand field of the PROC statement is different from the coding in 
the prototype statement: 






PROTOTYPE 


&symboi  calt-name | daxeg &pos, &key .=,...,dkey = 









CALL 


symbol call-name | p.,..., P,,-key ,=value,...,key , =value 


You specify positional parameters by indicating a variable symbol in operand 1, and you 
indicate the number of positional parameters to appear in the call in operand 2. If you 
want a mixed mode call, the keyword parameters are indicated by coding keyword variable 
symbols starting in operand 3. You specify keyword-parameters only, by coding commas in 
operand 1 and 2 and then coding the keyword parameter variable symbols. The PROC 
statement is used to indicate the /abe/-argument and the parameter-specifications, and the 
NAME statement is used for specifying the ca//-name. 
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In effect, what the NAME statement does is to make the ca//-name an independent entity in 
the PROC heading. Since the ca//-name is disassociated from the parameter-specifications, 
it becomes easy to introduce another method of parameter submission without having any 
effect on the variable symbols in the heading. This order parameter is positional parameter 
zero and is submitted in the operand field of the NAME statement. Each value you want 
positional parameter zero to have must be coded in the operand field (pos-O) of a separate 
NAME statement. And each NAME statement must have a different ca//-name in the /abe/ 
field. Thus, you can vary the value of positional parameter zero by varying the ca//-name 
used in the call instruction. At any point in time, positional parameter zero has the value of 
the pos-O coded in the operand field of the NAME statement that matches the ca//-name 
used in the call instruction. The PROC makes positional parameter zero possible through 
efficient use of two fields that are unused in the MACRO heading. These two fields are used 
in the PROC to disassociate the ca//-name from the parameter-specifications and split the 
call design responsibility between the two heading statements. 


So, where the MACRO uses one statement in the heading to communicate directly with the 
call line, the PROC uses both statements, one statement for associating parameter 
replacement and another for naming the ca//-name. Using the one statement in the heading 
to interface the call-line instead of two, as the PROC does, seems like a straight-forward 
way of doing things. But when you read about how to use the PROC, you'll find the split- 
heading characteristic of the PROC heading works to your advantage. The PROC offers one 
more additional parameter reference (positional parameter zero) and intrinsically allows the 
body to reference the parameters in the call line by the number of the position and not by 
the symbolic name of the position. 


A complete picture of the PROC and MACRO construction compared with the call 
instruction format is shown in Figure 24—2. It shows the format of the heading, body, and 
trailer for each type of macro definition. The rules for coding the model statements in the 
body are the same for the PROC and MACRO. These rules are: 


= The label field may contain a symbol, a variable symbol, or a sequence symbol, 
depending on the operation defined. Comments statements may not be created by 
substitution for variable symbols. 


= The operation field may contain any machine, assembler, or macro instruction 
mnemonic code except END, ICTL, or ISEQ. 


= Either ordinary symbols or variable symbols may be written in the operand field. The 
size of this field may not exceed 240 characters after substitution. 


= The comments field may contain any combination of characters; however, substitution 
for variable symbols is not performed on this field by the assembler. Comments are 
written in the format of the statement the model represents. 


= A macro instruction that is a model statement within a macro definition is called an 
inner macro instruction, while a macro instruction in the program source module is 
called an outer macro instruction. A macro instruction that appears in a macro 
corresponding to an outer macro instruction is called a second-level macro instruction. 
Macro instructions within macro definitions are nested. The number of levels to which 
macro instructions may be nested in an assembly depends upon the amount of main 
storage available to the assembler. 
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= Because COPY statements within a macro definition are processed prior to the 
generation of code from a macro definition, they are not considered to be model 
statements nor are they ever processed as such. 


The trailer indicates the end of a macro definition. The mnemonic code END is used in the 
PROC and MEND is used in the MACRO. The /abe/ and operand fields are not used. 


PROC CONSTRUCTION 


LABEL AOPERATIONA OPERAND 


PROC (pon) [Bev ,=-.-&key,. =] 
[pos-0] 












HEADING 







Operands 





mnemonic-code operands 





MACRO CONSTRUCTION 


LABEL AOPERATIONA OPERAND 


HEADING 








key ©)... Makey, = 
BODY symbol ] mnemonic-code operands 
&symbol i ‘ 
) symbol { 
mnemonic-code Operands 
CALL INSTRUCTION FORMAT 
LABEL OPERATION A OPERAND 

[symbo!] call-name [p,.P. rePogo] 


Figure 24—2. PROC, MACRO, and Call Instruction Comparison 


24.3. PASSING PARAMETERS TO THE BODY 


The discussion of the heading thus far has been from the call instruction design point of 
view, but the heading also establishes a homologous relationship between the call 
instruction and the body. Body references to the values in the call instruction stem from 
the variable symbols used for designing the call instruction. The variable symbols used in 
the heading to represent the /abe/ and operand fields of the call instruction are used as 
arguments in the body to reference the values in the call instruction. Variable symbols in 
the body that directly reference values in the call instruction are called symbolic 
parameters. When you use a symbolic parameter in the body, you are directly referencing 
its associated value in the call instruction and, when you call the definition, the values in 
the call are substituted in place of the symbolic parameters. This call-to-body 
communications cycle is as follows: 
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MACRO CALL INSTRUCTION 





| symooi— | callname peraneeaes 
label parameter 
argument specifications 


symbolic parameter specifications 






&pos(n) 
or &key 










&symbol 
value for 
referenced label 


value for 
referenced parameter 


BODY 


TRAILER 


The heading of the macro definition thus serves not only as the design medium for the 
macro call instruction but also dictates how the arguments in the body are to reference the 
values in the call instruction. Coordination of values and arguments is accomplished by 
using variable symbols in the /abe/-argument and parameter-specifications fields of the 
heading. The variable symbols used in the heading to represent the symbo/, and the values 
in the parameter-/ist, are the variable symbols used in the body to reference the /abe/ and 
operand fields of the macro call instruction. Communications between a macro call 
instruction and a macro definition that is capable of variable parameter replacement is 
shown in Figure 24—3. 


The following sequence of events occurs when a macro call is issued: The macro facility 
finds the macro definition called upon, matches the parameters given in the call to the 
variable symbols in the heading, and (wherever the body references a variable symbol in the 
heading), plugs the matched value into the body. Then, the body, with the substituted 
parameters, is put in the source program where the macro call instruction appeared. A 
variable symbol in a macro definition body represents either the label in an issued macro 
call instruction or one of the operands in that macro instruction. 
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PROGRAM SOURCE CODE MACRO DEFINITION 


CALLMAC START 0 


BEGIN BALR 6,0 


USING *6 @) | 2 p3, 
STORE 5, RAG, BAG, SAG 


p4 } heading 


5, BAG 


5, SAG 


13, SAVE 
AB, CD } trailer 


EF, GH 





Call the macro. 





Substitute the parameters. 


OOO 


Intine expansion 


p Variable symbol 


Figure 24—3. Communication between Macro Instruction and Macro Definitron 


When a variable symbol appears as a symbolic parameter in a model statement, it may be 
concatenated (joined) with other variable symbols or characters. Some combinations of 
variable symbols and characters require a period as a separator between the variable 
symbol and the joined character to distinguish where the variable symbol stops and the 
concatenation begins. Other combinations do not require a period as a connector because 
the concatenation is implied by certain characters that are recognized as character string 
terminators. When the period is properly used as a concatenator, it will not appear in the 
generated inline expansion code. The replacement value for the variable symbol and the 
concatenated string appear as one string in the inline expansion code. 


The period must be used to concatenate a character string that immediately follows a 
variable symbol if that character string starts with a letter, digit, left parenthesis, or period. 
Some examples of this are: 


&Z.BC 
&Z.12 
&Z.(5,6) 
&Z..BC 
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If the replacement value for the variable symbol &Z is 12, the values generated in the inline 
expansion code would be: 


12BC 
1212 
12(5,6) 
12.BC 


The opposite combination reproduces the intended concatenation period in the inline 
expansion code. If you code a character before a variable symbol, don’t use a period to 
concatenate the character with the variable symbol. The period, in this particular 
combination, is not considered to be a concatenator. A character coded before a variable 
symbol does not have to be concatenated with the variable symbol; the period is considered 
to be part of the character code and is generated as such. Take each previous example and 
switch the variable symbol and the characters: 


BC.&Z 
12.&Z 
(5,6).&Z 
BC..&Z 


If &Z has a replacement value of 12, the following would be generated inline: 


BC.12 
12.12 
(5,6).12 
BC..12 


The period will not be generated, however, if the character coded before the variable symbol 
is contained within quotes. The following is the proper way to concatenate a variable symbol 
prefixed with a character string if the period is used: 


‘BC’ &Z' 
12° &2Z' 
‘(5,6)'."&2Z’ 
‘BC’ &Z' 


However, it isn’t necessary to concatenate a variable symbol with a prefixed character. If 
you code: 


BC&Z 
12&Z 
(5,6)&Z 
BC.&Z 


and &Z equals 12, then the following would be generated: 


BC12 
1212 
(5,6)12 
BC.12 
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You do not need a period after a variable symbol to indicate concatenation, if the variable 
symbol is followed by another variable symbol or a special character other than a left 
parenthesis or a period. Some examples of this are: 


&A&B 
&A+23 
&AAB 
&A=23 


You could use periods as concatenators in these examples with no adverse side effects. 
If &A equals TAG and &B equals 1, then the following is generated inline: 


TAG1 
TAG+23 
TAGAB 
TAG=23 


There are really only two items that you can concatenate with variable symbols: characters 
and other variable symbols. When concatenating variable symbols with variable symbols, 
the period is optional and, when certain combinations of characters are concatenated with a 
variable symbol, the period is necessary. 


Each format uses a different method for coding symbolic parameters to reference positional 
parameters, and this relates back to differences in the parameter-specifications between the 
PROC and MACRO. The PROC specifies positional parameters by indicating a variable 
symbol in operand 1 and the number of positional parameters in the call in operand 2. The 
variable symbol in operand 1 of the PROC statement is the symbolic parameter used in the 
body to reference positional parameters in the call. In addition to coding the symbolic 
parameters, you must also give the position of the parameter in parentheses immediately 
following the symbolic parameter: &pos(n). You do not give a positional reference after the 
symbolic parameter when referencing positional parameters in a MACRO body. The MACRO 
works differently because the prototype statement has to give a different variable symbol for 
every positional parameter in the call. To reference a positional parameter from a MACRO 
body, the symbolic parameter that you use is the variable symbol in the prototype statement 
that represents the desired positional value. This means you must keep track of all the 
variable symbols used to represent positional parameters, while with the PROC, you only 
require one variable symbol for the symbolic parameter. However, you can use the system 
variable symbol (&SYSLIST) in a macro to reference by position. (See 26.2.) 


Symbolic parameter references to keyword parameters and symbolic parameter references 
to the label field of the call are the same for the PROC and MACRO. The symbolic parameter 
used to reference a keyword parameter in the call is the &key portion of the variable symbol 
used in the heading to represent the keyword parameter. And the symbolic parameter used 
to reference the /abe/ field of a call instruction is the variable symbol used as a /abel- 
argument in the heading. These symbolic parameters are used the same way for both 
formats because the mechanics for coding them in each heading are the same. 
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The details of how to use symbolic parameters in model statements in the PROC and the 
MACRO are given in Sections 25 and 26. PROC design of cal! instructions is encouraged 
because it is easier and because most of the call instructions designed by Sperry Univac are 
PROCs. Model statements using symbolic parameters are shown in Figure 24—4. More 
detailed examples of PROCs and MACROs are given in Section 30. 


PROC Format 


To write the macro in PROC format: 


Statements LABEL AOPERATIONA OPERAND 


Proc 
Name 


Model 13,&TAG(1) 
\ Body 


Heading &TAG,3 


Model 13,&TAG(2) 
Model 13,&TAG(3) 
End } Trailer 

To call the macro (macro call instruction): 


cali | PAY,RAISE,TOTAL 


Generates this pattern of coding: 


13,PAY 
13,RAISE 
13, TOTAL 


To write the macro in MACRO format: 
Statements LABEL 


Macro 


Prototype &TAG1,&TAG2,&TAG3 
Model 13,aTAG1 
\ Body 


Heading 


Model 13,&aTAG2 
Mode! 13,&TAG3 
Mend } Trailer 

To call the macro (macro call! instruction): 


CAL2 PAY,RAISE,TOTAL 


Generates this pattern of coding: 


13,PAY 
13,RAISE 
13,TOTAL 





Figure 24—4. Example MACRO and PROC Definitions 
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25. PROC Format 


25.1. BASIC PROC DESIGN 


The most basic type of PROC that you can design is one that requires no parameters from 
the call, no label, and no positional or keyword parameters in the operand field. All that is 
required is a mnemonic in the operation field. 





A OPERATION A OPERAND 


When this type of call is used, it generates the same sequence of instructions with no 
parameter replacement. The call instruction ADD1 is designed to generate the following 
code every time it is used in a source program: 







A OPERATION A OPERAND 





13,PAY 
13,RAISE 
13, TOTAL 


The design structure of a PROC that accomplishes this type of basic inline expansion is: 


LABEL A OPERATION A OPERAND 
PROC 
call-name NAME 


mnemonic-code operands 


mnemonic-code operands 
END 
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The PROC and NAME statements make up the heading of the PROC and must always be 
coded in the order shown. You use the PROC statement to identify the beginning of a macro 
definition in PROC format and the NAME statement to assign a ca//-name to the PROC. The 
call-name is coded in the /abe/ field of the NAME statement and is a 1- to 8-character 
symbol (it cannot be a variable symbol) defining the mnemonic operation code by which the 
macro defintiion may be referenced. The ca//-name must be unique. It may not be the same 
as any Sperry Univac mnemonic operation code or any ca//-name in your own library. (The 
only way that you can duplicate a ca//-name is if you override the established ca//-name 
with the OPSYM directive. See 16.2.) 


After the NAME statement is the body that contains the model statement and then the 
trailer, an END statement that indicates the end of the PROC. The model statements in the 
body are the source code statements that are generated when you use the ca//-name in your 
program. If you don't require parameter replacement, the model statements could be any 
BAL instruction, assembler directive, or call instruction except END, ICTL, or ISEQ. 


The model statements for the ADD1 call are the BAL instructions that are generated every 
time ADD1 is used. A completely designed ADD1 PROC is as follows: 






A OPERATION A OPERAND 





13,PAY 
13,RAISE 
13, TOTAL 


Although the basic PROC design that accomplishes direct instruction substitution saves the 
programmer time and effort, the most valuable role of the macro definition in BAL is 
variable parameter replacement. Variable parameter replacement allows you to vary the 
value of the /abe/l, operation, or operand field of any model statement by using the 
parameters submitted with each call. This means that you can design the ADD1 example 
PROC so that it accepts values from the call line and replaces the PAY, RAISE, and TOTAL 
operands of the model statemens with the call line values. To accomplish parameter 
replacement in model statements, you indicate the fields that are variable by using symbolic 
parameters. 


The symbolic parameter is the type of variable symbol used to indicate variable parameter 
replacement directly from the call line to the body. You can use symbolic parameters in the 
label, operation, or operand field of model statements to indicate parameter replacement. If 
you wanted the PAY, RAISE, and TOTAL operands of the ADD1 example to be variable, you 
would code symbolic parameters for those operands. The symbolic parameters in the model 
statements reference the values in the call through the PROC statement, and no symbolic 
parameter may be used in a model statement unless it also appears in the PROC statement. 
The value referenced in the call line replaces the symbolic parameter, and the manner in 
which you reference the parameters in the call depends on the kinds of parameters you 
design the call to have. 


As shown in Figure 22—1, comments or instructions within a PROC call will be shifted 
one space beyond the last operand when they are assembled. This permits a maximum 
amount of space for comments on instructions that generate variable symbols. 
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25.2. REFERENCING POSITIONAL PARAMETERS IN THE CALL 


You can define the call to submit values to the PROC body via positional parameters. This is 
done by indicating a variable symbol in operand 1 of the PROC statement and by indicating 
the total number of positional parameters that can appear in the call in operand 2 of the 
PROC statement: 





A OPERATION A OPERAND 


The &pos variable symbol is the symbolic parameter used in the body of the PROC to 
reference positional parameters in the call instruction. Following the symbolic parameter is 
a decimal number in parentheses (&pos(n)) that references the positional parameter in the 
call. For instance: 


&pos(1) references positional parameter 1 in the call. 
&pos(2) references positional parameter 2 in the call. 
&pos(3) references positional parameter 3 in the call. 


You can reference a positional parameter from the /abel, operation, or operand field of a 
model statement, and the value coded in the referenced position in the call line is 
generated in place of the symbolic parameter. If an omitted positional parameter is 
referenced, a null character string is generated in place of the symbolic parameter that 
made the reference. The following example shows the PROC source code and inline 
expansion code for an ADD2 call instruction that is designed to submit three positional 
parameters. 


PROC SOURCE CODE CALL INSTRUCTION 


PROC &TAG,3 : ADD2 450,40,TOTAL 
ADD2 NAME 
INLINE EXPANSION CODE 


L 13,=F’&TAG(1)’ 
A 13,=F’&TAG(2)' 
ST = 13,&TAG(3) 




























L 13,=F’450" 
A 13,=F’'40’ 
ST 13, TOTAL 
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Operand 1 of the PROC statement indicates the variable symbol &TAG is used as the 
symbolic parameter reference in the body, and operand 2 indicates that there can be three 
positional parameters in the call. The NAME statement assigns the ca//-name ADD2 as the 
mnemonic to call the PROC. The body is a model for a procedure that adds two numbers and 
stores the result in a main storage location. The two numbers are picked up from positional 
parameter 1 of the call instruction, which is someone's pay, and positional parameter 2, 
which is their raise. The main storage location is picked up from positional parameter 3 of 
the call instruction. (One of the requirements for using this call instruction is that the user 
supply a DS statement with a symbo/ the same as that of positional parameter 3 for the 
PROC to store the result.) The first model statement is a /oad instruction that uses a variable 
symbol in operand 2 to reference positional parameter 1 in the call instruction. The PROC 
generates the /oad instruction with a full-word fixed-point literal value of 450 in operand 2. 
The add instruction is generated with a 40 in operand 2, and the main storage address 
TOTAL is generated in operand 2 of the store instruction. 


25.3. REFERENCING KEYWORD PARAMETERS IN THE CALL 


Instead of having the call submit values to the PROC body via positional parameters, you 
can use keyword parameters. This is done by using keyword parameter variable symbols 
starting in operand 3 of the PROC statement. Commas are used in operands 1 and 2 to 
indicate there are no positional parameters in the call (and key is the keyword name): 





A OPERATION A OPERAND 


Since a variable symbol can only be eight characters long and we've used two positions 
with the ampersand and equal sign, the keyword name portion of the variable symbol can 
only be six characters long. But the keyword name in the call can exceed six characters and 
still be accepted by the PROC. However, anything after six characters is ignored by the 
PROC; it recognizes only the first six characters as the true keyword name. 


The symbolic parameter used in the body of the PROC to reference keyword parameters in 
the call is the variable symbol indicated in the PROC statement, without the equal sign 
(&key). 
For instance: 

&PAY references keyword parameter PAY=value in the call. 


&RAISE references keyword parameter RAISE=value in the call. 


&SAVE references keyword parameter SAVE=value in the call. 
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You can reference a keyword parameter from the /abel, operation, or operand field of a 
model statement, and the value after the equal sign in the call line will be generated in 
place of the symbolic parameter. The following example shows the PROC source code and 
inline expansion code for an ADD3 call instruction that is designed to submit three keyword 
parameters: 


PROC SOURCE CODE CALL INSTRUCTION 


PROC  ,,&PAY=,&RAISE=,&SAVE= ADD3 PAY=450,RAISE=40,SAVE=TOTAL 
ADD3 NAME 
INLINE EXPANSION CODE 


13,=F’&PAY’ 
A 13,=F’&RAISE’ 
13,&SAVE 












L 13,=F‘450’ 
A 13,=F’40' 





ST 13, TOTAL 





Operands 3 through 5 of the PROC statement indicate that there can be three different 
keyword parameters in the call with the keyword names of PAY, RAISE, and SAVE. The 
NAME statement assigns the ca//-name ADD3 as the mnemonic to call the PROC. (The body 
of this PROC is designed to perform the same function as the ADD2 example PROC.) The 
symbolic parameter &PAY in operand 2 of the first model statement references the keyword 
parameter PAY in the call, and since PAY=450, the value 450 is substituted in operand 2 of 
this model statement. The same processing takes place with symbolic parameters &RAISE 
and &SAVE. 


You can design a PROC so that a preselected value is generated for a symbolic parameter 
that references an omitted keyword parameter in the call. Otherwise, symbolic parameters 
that reference omitted keyword parameters receive the value of a null character string. The 
default value for a keyword parameter is coded after the equal sign of the variable symbol in 
the PROC statement. 


The following example shows a PROC with a default value indicated in the PROC statement: 


PROC SOURCE CODE CALL INSTRUCTION 


PROC  ,,&PAY=,&RAISE=40,&SAVE= ADD4 = PAY=490,SAVE=TOTAL 
ADD4 NAME 
INLINE EXPANSION CODE 


L 13,=F'&PAY’ 
A 13,=F’&RAISE’ 
13,&SAVE 







13,=F’490' 
13,=F’40' 





13, TOTAL 





The call instruction doesn’t use the RAISE keyword parameter so the default value of 40 
indicated in the PROC statement is generated in the inline expansion code. 
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Another type of PROC is one with mixed-mode parameters. This PROC is designed to accept 
both positional and keyword parameters from the call. The format of the PROC statement for 
designing mixed-mode calls is: 





A OPERATION A OPERAND 





&pos,n,&key, =,...,Btkey, = 





We could design the ADD4 example PROC to have the call submit the &PAY symbolic 
parameter as a positional parameter and the &SAVE and &RAISE symbolic parameters as 
keyword parameters, with RAISE having a default value of 40: 


PROC SOURCE CODE CALL INSTRUCTION 


PROC &PAY,1 |&SAVES, &RAISE=40 ADD5 530,SAVE=TOTAL 
ADDS NAME 
INLINE EXPANSION CODE 


L 13,=F’&PAY (4) 
A 13,=F’&RAISE’ 
ST 13,&SAVE 









L 13,=F'530' 





A -13,=F*40' 
ST 13,TOTAL 





The following example shows what happens if you have a default value indicated in the 
PROC statement and submit a value for the keyword in the call instruction; the value in the 
call overrides the value in the PROC heading: 


EROE SOURCE CODE CALL INSTRUCTION 


PROC &PAY,1,&SAVE=, &AAISE=40 ADDS 530,SAVE=TOTAL,RAISE=60 
ADDS NAME 


L  1S=FPAY(1) INLINE EXPANSION CODE 


A 13,=F'&RAISE’ 


ST 13,&SAVE L 13,F’530’ 


A 13,=F’60’ 
ST 13,TOTAL 
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25.4. REFERENCING SUBPARAMETERS IN THE CALL 


Another way to generate values in a field of a model statement is by referencing values in 
a parameter sublist. The parameter sublist is a list of subparameters that are subordinate 
to either a positional or keyword parameter. When you use a sublist, you can submit 
multiple parameter values from a single operand in the call. No coding is required in the 
PROC statement to support a sublist in a call line. It is a matter of referencing the sublist 
from a model statement by using a symbolic parameter with a sublist reference. The 
symbolic parameter reference to a subparameter in a positional parameter sublist is: 


&pos(n,x) 
where: 
&pos 


Is the variable symbol used in operand 1 of the PROC statement to represent 
positional parameters. 


Is the number of the positional parameter in the call. 


Is the position of the subparameter in the sublist. (All subparameters are 
referenced by position.) 


Sublists for positional parameters must be coded within parentheses in the operand field of 
the call: 


(Par, Pao, Pan) MPa qe Paix) 


The following example shows a PROC referencing a positional parameter sublist in the call 
line: 


PROC SOURCE CODE CALL INSTRUCTION 


PROC &TAG,2 , 


L 13,=F’&TAG(1)’ 
A 13,=F’&TAG(2,1)’ 
ST = 13, &TAG(2,2) 











ADD7 450, (40,TOTAL) 







INLINE EXPANSION CODE 


13,=F'450° 
13,=F’40’ 


13, TOTAL 
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The symbolic parameter reference to a subparameter in a keyword parameter sublist is: 
&key(x) 
where: 
&key 
is the variable symbol in the PROC statement. 
Is the number of the position of the subparameter in the sublist. 


Sublists for keyword parameters must be coded within parentheses after the equal sign in 
the operand field of the call: 


k,=(P4,..-.D eave n—(P1,--.P x) 


The following example shows a PROC referencing a keyword parameter sublist in the call 
line: 


PROC SOURCE CODE CALL INSTRUCTION 
ADD8 PAYRAS=(450,40),SAVE=TOTAL 












PROC ,&PAYRAS=,&SAVE= 





ADDS NAME — 





13,=F'&PAYRAS(1)’ 






INLINE EXPANSION CODE 


13,=F'450' 
13,=F'40’ 


13, TOTAL 





In addition to having the individual subparameters in a call generated in model statements, 
you can have the entire sublist generated. You do this by referencing the positional or 
keyword parameter with no reference to its subparameters. Simply use the symbolic 
parameter as you normally would reference a keyword or positional parameter; and its 
associated sublist, including the parentheses, will be generated. If a SET symbol appears 
in the operand entry of a macro instruction, attribute information is not provided and the 
operand may not be accessed as a sublist. 
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25.5. MULTIPLE PROC NAMES AND POSITIONAL PARAMETER 0O 


The split heading characteristic of the PROC permits another means of parameter 
modification. The parameter value is submitted by varying the mnemonic name in the 
operation field of the call. You can design a PROC so it may be called by many mnemonic 
names, and each name represents a different parameter value. This is easily done in the 
PROC because the NAME statement separates the ca//-name from the parameters in the 
PROC statement and therefore leaves the operand field of the NAME statement open for 


use. The PROC utilizes the operand field of the NAME statement for assigning a value to the 
call-name: 








AOPERATION A OPERAND 


call-name 


pos-O can be a decimal or alphanumeric value but it cannot be a variable symbol. The 
value in the operand field of the NAME statement is referenced as positional parameter O 
by using the same symbolic parameter you indicated in operand 1 of the PROC statement 
(&pos(O)). You can vary the value for positional parameter O by using multiple NAME 
statements. Each NAME statement has a different ca//-name and a value in the operand 
field for positional parameter O. A symbolic parameter referencing positional parameter O 
receives the pos-O value from the NAME statement whose ca//-name is used in the 
operation field of the call. All NAME statements must appear directiy after the PROC 
statement and before any model statements, including comments. 
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We could design the ADD2 example PROC to have to have several different ca//-names and, 


each time a different ca//-name is used, the register number for operand 1 of the model 
statements is changed: 


CALL INSTRUCTION 1 


ADDS 450,40,TOTAL 








INLINE EXPANSION CODE 


L 13,=F'450" 
A 13,=F'40' 
ST 13,TOTAL 


PROC SOURCE CODE 


PROC  &TAG,3 


ADDS NAME .. 13 
ADD10 NAME. 12 
ADD1t1 NAME 17 

















CALL INSTRUCTION 2 


ADD10 450,40,TOTAL 















L &TAG(0),=F’&TAG(1)' 
A &TAG(0) =F’&TAG(2)’ 


INLINE EXPANSION CODE 
ST &TAG(0) ,&TAG(3) 


L12,=F'450" 
A -12,=F'40' 
ST  12,TOTAL 





CALL INSTRUCTION 3 


ADD11 450,40, TOTAL 


INLINE EXPANSION CODE 


L 11,=F’450' 
A 11,=F'40 


ST 11,TOTAL 
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25.6. THE LABEL ARGUMENT 


The /abel-argument is used to reference the symbol coded in the /abe/ field of a call 
instruction. To establish a /abe/-argument, you must code a variable symbol in the /abel field 


of the PROC statement. The format of the PROC statement with a /abe/-argument is as 
follows: 





A OPERATION A OPERAND 






&pos,n,&key, =,..,&key_ = 


m 


The variable symbol that is coded in the /abe/ field of the PROC statement is used as the 
reference to the symbol in the /abe/ field of the call instruction. This variable symbol is used 
to take the label field from a call instruction and generate it in a model statement. Any 
model statement can have a /abel-argument. A label-argument is useful when you use a 
label in a PROC and you expect several copies of the inline expansion code to be in one 
program. The user can change the name of the label by changing the symbol in the label 
field of the call. 


The following PROC uses a /abel-argument. The purpose of this PROC is to add the number 
of salaries indicated in positional parameter 1 and located where indicated by keyword 
parameter RAISE. The results are stored in the location indicated by keyword parameter 
TOTAL, and control is returned to the user program at the location indicated by keyword 
parameter OUT. 


CALL INSTRUCTION 


GROUP1 PLUS 4,PAY=PAY1,RAISE=RAISE1,TOTAL=TOTAL1,OUT=EXEMPT 


PROC SOURCE CODE 





















&LABEL PROC &COUNT,1,&PAY=,&RAISE=,&TOTAL=,80UT= 


PLUS NAME 


LA 8, &PAY 

LA 9,&RAISE 

LA 10,&TOTAL 
&LABEL L 13,0(8) 














INLINE EXPANSION CODE 















LA 8,PAY1 

LA 9,RAISE1 

LA 10,TOTAL1 
GROUP1 L 13,0(8) 
















A 13,0(9) A 13,0(9) 

ST 13,0(10) ST —13,0(10) 

A 12,=F'1’ A 12,=F‘1' 

Cc 12,=F'&COUNT’ Cc 12,=F'4' 
BC 8,&OUT BC  8,EXEMPT 
A 8=F’4! A 8=F‘4' 

A 9,=F'4’ A 9,=F'4’ 

A 10,=F'4’ A 10,=F'4' 

B &LABEL B GROUP1 
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26. MACRO Format 


26.1. BASIC MACRO DESIGN 


A basic MACRO does not perform variable parameter substitution and, therefore, does not 
require any values to be passed from the call instruction. The design structure uf a MACRO 
that accomplishes this type of basic inline expansion is: 







AOPERATION A OPERAND 









MACRO 
call-name 


mnemonic-code operands 





mnemonic-code operands 


MEND 


The statements in a MACRO must always be coded in the order shown. First is the MACRO 
statement which indicates the beginning of a macro definition in MACRO format. Next is the 
prototype statement, which is where you code the ca//-name. Then, you code the model 
statements, which can be any BAL instruction, assembler directive, or call instruction 
except END, ICTL, or ISEQ. The last statement in a MACRO is the MEND statement, which 
indicates the end of the definition. 


lf we take the ADD1 PROC shown in Section 25 and design an ADD1 MACRO, it appears as 
follows: 






A OPERATION A OPERAND 





13,PAY 
13,RAISE 
13, TOTAL 
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The ADD1 example MACRO produces the same inline expansion code as the ADD1 example 
PROC: 






A OPERATION A OPERAND 






13,PAY 
13,RAISE 
13, TOTAL 


As shown in Figure 22—1, comments on instructions within a MACRO call will be shifted 
one space beyond the fast operand when they are assembled. This permits a maximum 
amount of space for comments on instructions that generate variable symbols. 


26.2. REFERENCING POSITIONAL PARAMETERS IN THE CALL 


Designing a MACRO to reference positional parameters in the call is a little different from 
the way it is done in the PROC. In MACRO. design, the prototype statement must indicate a 
variable symbol for each positional parameter to be coded in the call. Positional parameter 
variable symbols are coded in the prototype statement as follows: 







A OPERATION A OPERAND 


call-name &pos, p++, SPOS, 


The variable symbol representing a positional parameter in the call is used as the symbolic 
parameter to reference that positional parameter. You can reference a positional parameter 
from the /abel, operation, or operand field of a model statement, and the value coded in the 
referenced position in the call is generated in place of the symbolic parameter. If an omitted 
positional parameter is referenced, a null character string is generated in place of the 
symbolic parameter that made the reference. 


The following example shows the ADD2 example PROC given in Section 25 recoded in 
MACRO format: 


MACRO SOURCE CODE CALL INSTRUCTION 


ADD2 450,40,TOTAL 


SPAY,&RAISERTOTAL 





INLINE EXPANSION CODE 







13,=F’&PAY’ 
13,=F’&RAISE’ 
13,&TOTAL 








L 13,=F'450’ 
A 13,=F’40' 
ST 13, TOTAL 
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You can also reference the positional parameter values in the call by position rather than by 
using the symbolic parameters coded in the prototype statement. To do this, you must use 
the system variable symbol &SYSLIST. Instead of coding the positional parameter variable 
symbol for the symbolic parameter reference, you code: 


&SYSLIST(n) 
where: 


n 


Is the number of the positional parameter in the call and can be an expression that 
is a self-defining term or a SETA symbol. (SETAs are discussed in Section 27.) 


If you miscount the positional parameter string in the call and n is greater than the actual 
number of parameters that are supposed to be in the call, then a null character string is 
generated in place of &SYSLIST(n). When you use &SYSLIST, it isn’t necessary to have 
positional parameter variable symbols in the heading. &SYSLIST references the call 
instruction, not the heading. The function of &SYSLIST is to provide the MACRO designer 
with the option to reference positional parameters by position, similar to the way it is done 
in the PROC. However, &SYSLIST does not allow you to reference keyword parameters by 
position as you could do in the PROC. In the PROC, you could use &pos(n+1) and continue 
right on through into the keyword parameters in the parameter-list. This won't work with 
&SYSLIST because &SYSLIST only references positional parameters. 


The following example shows the ADD2 example MACRO redesigned with &SYSLIST 
symbolic parameter references: 


MACRO SOURCE CODE CALL INSTRUCTION 


ADD2 450,40,TOTAL 


INLINE EXPANSION CODE 






MACRO 

















13,=F’&SYSLIST(1)’ 
A 13,=F’&SYSLIST(2)’ 
13,&SYSLIST(3) 13,=F’450’ 
A 13,=F'40' 

13, TOTAL 
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26.3. REFERENCING KEYWORD PARAMETERS IN THE CALL 


The MACRO references keyword parameter values in the call in the same way as the PROC. 
A keyword parameter reference is made by a symbolic parameter that consists of the &key 
portion of the keyword variable symbol. If the call is to have only keyword parameters, the 
prototype statement is coded as follows: 








A OPERATION A OPERAND 


call-name 


You can reference a keyword parameter from the /abel, operation, or operand field of a 
model statement and the value after the equal sign in the call will be generated in place of 
the symbolic parameter. 


The following is the ADD3 example PROC, shown in Section 25, recoded in MACRO format: 


MACRO SOURCE CODE CALL INSTRUCTION 


ADD3 PAY=450,RAISE=40,SAVE=TOTAL 


INLINE EXPANSION CODE 


-ADD3 &PAY=,&RAISE=,&SAVE= 





13,=F’&PAY’ 
13,=F‘&RAISE’ 
13,&SAVE 13,=F'450' 


13,=F'40’ 


13, TOTAL 





If you want any of the keyword parameters in the call to have a default value, you code that 
value after the equal sign of the keyword variable symbol in the prototype statement. 
Whenever a keyword parameter in the call is omitted, the symbolic parameter receives the 
value given the keyword variable symbol. A symbolic parameter referencing a keyword 
parameter that doesn’t have a default value receives the value of a null character string. 


To design a MACRO that references positional and keyword parameters in the call, you code 
the positional symbolic parameters before the keyword symbolic parameters in the prototype 
statement. The prototype statement for a mixed-mode MACRO is as follows: 


LABEL A OPERATION A OPERAND 


call-name &pos, p+&POS, Akey, =,...,Key = 
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} The following example shows the ADD5 example PROC, shown in Section 25, redesigned in 
MACRO format: 


MACRO SOURCE CODE CALL INSTRUCTION 


ADDS 530,SAVE=TOTAL 


INLINE EXPANSION CODE 





SPAY, BSAVE=&RAISE=40 


13=F‘&PAY’ 


13,=F'&RAISE’ 
13,&SAVE 


13,=F'530' 
13,=F'40' 


13, TOTAL 





26.4. REFERENCING SUBPARAMETERS IN THE CALL 


Like the PROC, the MACRO does not require support from the heading to use sublists in the 
call. It is a matter of referencing the sublist from a model statement by using a symbolic 
parameter or &SYSLIST with a sublist reference. The &SYSLIST reference to a 
subparameter in a positional parameter sublist is: 


@ &SYSLIST(n,x) 
where: 


n 
Is the number of the positional parameter in the call. 


Is the number of the subparameter in the sublist. 


The following example shows the ADD7 example PROC, shown in Section 25, recorded in 
MACRO format: 


MACRO SOURCE CODE CALL INSTRUCTION 


ADD7  &PAY,&RAISETOT 


L 13,=F'&PAY’ 
A 13,=F'&SYSLIST(2,1)' 
13,&SYSLIST (2,2) 











INLINE EXPANSION CODE 








13,=F'450" 
A 13,=F'40’ 
13, TOTAL 
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The symbolic parameter reference to a subparameter in a keyword parameter sublist for a 
MACRO is the same as for the PROC: 


&key(x) 
where: 
&key 
Is the variable symbol in the prototype statement. 
is the number of the subparameter in the sublist. 


The following example shows the ADD8 example PROC, shown in Section 25, redesigned in 
MACRO format: 


MACRO SOURCE CODE CALL INSTRUCTION 


MACRO 
ADD &PAYRAS=,&SAVE= 


13,F'&PAYRAS(1)’ 
A 13,F‘&PAYRAS(2)' 
13,&SAVE 






ADD8 PAYRAS=(450,40), SAVE=TOTAL 





INLINE EXPANSION CODE 






L 13,=F’450’ 





A 13,=F'40' 
ST 13, TOTAL 





If you reference a positional or keyword parameter with a sublist and do not include a 
reference to a subparameter within the list, you will generate the entire sublist, including 
parentheses, in place of the symbolic parameter. The same thing happens in a PROC. If a 
SET symbol appears in the operand entry of a macro instruction, attribute information is 
not provided and the operand may not be accessed as a sublist. 


26.5. THE LABEL ARGUMENT 


The label argument for a MACRO is used the same way it is used in the PROC. To 
establish the label argument, you must code a variable symbol in the label field of the 
prototype statement. The format of the prototype statement with a label argument is as 
follows: 












A OPERATION A OPERAND 





call-name 






&symbol 





&pos, ++ SPOS, key, =,... key, = 
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The following MACRO uses a label argument. This example MACRO is the PLUS example 
PROC recoded in MACRO format (25.6). 


CALL INSTRUCTION 


GROUP1 PLUS 4,PAY=PAY1,RAISE=RAISE1, TOTAL=TOTAL1,QUT=EXEMPT 








&LABEL PLUS 


&LABEL 





PROC SOURCE CODE 


MACRO 


&COUNT &PAY=,8&RAISE= &TOTAL=,820UT= 


8,&PAY 

9, &RAISE 
10,& TOTAL 
13,0(8) 
13,0(9) 
13,0(10) 
12,=F 1" 
12,=F'&COUNT" 
8,&0UT 
8,=F'4' 
9,=F'4' 
10,=F'4’ 

& LABEL 





INLINE EXPANSION CODE 


GROUP1 





8,PAY1 
9,RAISE1 
10, TOTAL 
13,0(8) 
13,0(9) 
13,0(10) 
12,=F'1' 
12,=F'4 
8,EXEMPT 
8,=F'4’ 
9,=F’4’ 
10,=F'4’ 
GROUP! 
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27. Conditional Assembly 


Conditional assembly statements are used to control the pattern of coding generated within 
a macro definition, and to define and assign values to set symbols that can be used to vary 
parts of generated statements. Conditional assembly statements are used by the 
programmer to direct the asssembler to: 


exclude lines of code from the assembler output; 
include a set of lines more than once in the assembly output; or 


establish and alter values to determine whether a set of lines should be included in the 
output listing. 


Table 27—1 lists the function of each conditional assembly statement. 


Table 27—1. Conditional Assembly Language Statements (Part 1 of 2) 


ACTR Sets a conditional assembly loop counter Branching 


An unconditional branch 


AIF A conditional branch 

*AIFB 

ANOP Provides a branch destination point for a location 
*LABEL that already contains a symbol or variable symbo! 


MEXIT Stops processing of macro definitions 


Defines starting point of the code and the number of 
times it is to be generated 


| ENDO Defines the end of the code to be repeated 


MNOTE Generates messages in macro definitions or program Used for generating messages 
PNOTE source code 


*Alternate mnemonic 























Used for defining the range 
for repetitive code 
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Table 27—1 Conditional Assembly Language Statements (Part 2 of 2) 


Declares a general-purpose local set symbol Used for declaring set symbols 
that are to be used only inside 
LCLA Declares an arithmetic local set symbol the macro definition that is 
declaring the set symbol 
LCLB Declares a Boolean local set symbol 
LCLC Deciares a character local set symbol 
GBL Declares a general-purpose global! set symbol 
GBLA Declares an arithmetic global set symbo! 
GBLB Declares a Boolean global set symbol 
GBLC Declares a character global set symbol 


SET Assigns an arithmetic or character string value 
to a set symbol 
SETA Assigns an arithmetic value to a set symbol 


SETB Assigns a binary value of 0 (false) or 1 (true) 
to a set symbol 


SETC Assigns a character value to a set symbol 


*Alternate mnemonic 

































Used for declaring set symbols 
that are to be used not only in 
the macro definition in which 
the set symbol is declared, but 
also outside the macro definition 
in other macro definitions 











Used to assign values to arithmetic, 
Boolean, or character set symbol 





27.1. SET SYMBOLS 


Set symbols are a type of variable symbol (Appendix G). The rules for writing set symbols 
are the same as for other variable symbols: 


= An ampersand (&) is followed by an alphabetic character followed by up to six 
additional characters (total maximum characters is eight) 


= = If the ampersand is omitted, the assembler interprets the character string as a symbol 
and not as a set symbol. 


The following are valid set symbols: 
&C 
&AI 
&PARAM 


The following are not valid set symbols for the reasons stated: 


CAT 
Valid for an ordinary symbo! but not as a set symbol; no leading ampersand. @ 





&1 
First character after & is not alphabetic. 
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& &S 12345678 
There are too many characters in the string (maximum length, including &, is eight 
characters). 


Because set symbols are evaluated in the macro generation phase of the assembler, they 
may be used as counters, switches, or values to control the sequence of code generated. 
Unlike an ordinary symbol, the value assigned to a set symbol may be altered during 
assembly. 


A set symbol may be either global or local. A global set symbol, once declared and given a 
value by a SET statement, retains the same value until that value is changed by another SET 
statement. A local set symbol is defined only within the macro definition in which it is 
declared. The value of a local set symbol! within one macro definition is not affected by the 
declaration of either a global or local set symbol with the same name in another macro 
definition. 


Set symbols must be declared after macro prototype or NAME statements and before being 
referenced. 
27.1.1. Local Set Symbols 
. A local set symbol is available for use only in the macro definition in which it is declared. 
Four statements are available for declaring local set symbols. The declarative chosen 
& determines the values to which the set symbol may be set and the type of SET statement 


used to assign the values. 


The basic format for a local set symbol declaration is: 







AOPERATION A OPERAND 





unused 


where: 
LCL 
Declares a general-purpose loca! set symbol. 
LCLA 
Declares an arithmetic local set symbol. 
LCLB 
@ Declares a Boolean local set symbol. 
LCLC 


Declares a character local set symbol. 
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$1,S2,...,Sn 
Are set symbol names. 





The operand field of the local set declaration may contain one or more set symbol names. A 
local symbol is considered defined when declared. A set symbol declared by an LCLA or 
LCLB statement is assigned an initial value of zero. 


A set symbol declared by an LCLC or LCL statement is assigned an initial value of a null 
character string. 


Examples: 
LABEL AOPERAT IONS -  OPERAND 
! 10 16 
1. LCLA &A,&B 
2. LCLB &BIG 
3. LCLC &BIG3 


1. Declares arithmetic local set symbols &A and &B. 


2. Declares a Boolean local set symbol &BIG. 





3. Declares a character local set symbo! &BIG3. 


27.1.2. Global Set Symbols 


Global set symbols are initialized only once and are used to pass values back and forth 
between macro definitions. A global set symbol is available to all macro definitions in which 
it is also declared. 


Four statements are available for declaring global set symbols. The declarative chosen 
determines the range of values to which the set symbol may be set and the type of set 
statement used to assign the values. 


The basic format for a global symbol declaration is: 







A OPERATION A OPERAND 


unused 
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@ where: 


GBL 
Declares a general-purpose global set symbol. 


GBLA 
Declares an arithmetic global set symbol. 


GBLB 
Declares a Boolean global set symbol. 


GBLC 
Declares a character global set symbol. 


$1,S9,0658n 
Are set symbol names. 


The operand field of the global set declaration may contain one or more set symbols. A 

global set symbol is considered defined when declared. It is initialized only once; that is, the 

first time it is declared. With subsequent declarations in other contexts, the global set 

symbol is available for use but is not reinitialized. A set symbo! must be declared before it is 

available for use. A set symbol declared by a GBLA or GBLB statement is assigned an initial 

value of zero. A set symbol declared by a GBLC or GBL statement is assigned an initial value 
3) of a null character string. 


If a set symbol is declared as a global set symbol in more than one macro definition, it must 
be declared with the same statement code in each macro definition. 


Examples: 
LABEL AOPERAT 10NA OPERAND 
| 10 16 
1. GBL &BR 
2. GBLA &SET1,&SET2 
3. GBLB &BUT 
4, GBLC &GLB 


1. Declares a general-purpose global set symbol. 
2. Declares arithmetic global set symbols. 
3. Declares a Boolean global set symbol. 


4. Declares a character global set symbol. 
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27.1.3. Set Symbol Value Assignment 





Four statements are provided to assign values to set symbols: SETA, SETB, SETC, and SET. 
The statement used depends on the statement chosen to declare the set symbol. 


wp SETA 

Assigns values to set symbols declared in either LCLA or GBLA. 
# SETB 

Assigns values to set symbols declared in either LCLB or GBLB. 
es SETC 

Assigns values to set symbols declared in either LCLC or GBLC. 
= SET 


Assigns values to set symbols declared in either LCL or GBL. 


27.1.4. SET Statement 


The SET statement can be used to assign either an arithmetic or character string value to a @ 
variable symbol declared by an LCL or GBL statement. 


The format of the SET statement is: 





A OPERATION A OPERAND 


where: 
&s 
ls a set symbol declared by LCL or GBL. 
SET 
Defines the operation. 
a 
Is a valid arithmetic expression. 
Cc 


ls a valid character expression. 
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When the operand of the SET statement contains an arithmetic expression, the value of the 
expression may range from —108—!' to + 108—'. When the operand of the SET statement 
contains a character expression, the maximum length that may be specified is eight 
characters. 


If a SET variable symbol is assigned a character value, a reference to the SET symbol yields 
the same result as a reference to a SETC symbol assigned the same character value. 
Similarly, if a SET variable symbol is assigned an arithmetic value, a reference to the SET 
symbol yields the same result as a reference to a SETA symbol assigned the same value. A 


SET variable symbol with a character value may be reassigned an arithmetic value, and vice 
versa. 


A SET expression is a SETA expression allowing the use of the operators ><, */,//,=,**, 
— —, and ++ in the SET expression when an arithmetic operator is valid. The two 
characters ** represent the logical product AND, the two characters ++ represent the 
logical sum OR, and the two characters — — represent the logical difference XOR. 


Each bit of the first term is compared with its corresponding bit in the second term, and the 
result of the comparison is placed in the corresponding position in the resulting term. The 
result of the bit comparison for each operator is: 





The three relational operators are the equal (=) operator, the greater than (>) operator, and 
the less than (<) operator. 


where: 
Compares the value of two terms or expressions. If the two values are equal, the 
assembler assigns a value of 1 to the expression. If the values are not equal, a 
zero value is assigned. 
> 


Compares two terms or expressions. If the value of the first (left) term is greater 
than the value of the second (right) term, a value of 1 is assigned to the 
expression. If the value of the second term is greater than the value of the first 
term, a zero value is assigned. 
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Compares the value of the first (left) expression or term with the second (right) 
expression or term. If the value of the first expression or term is less than the 
value of the second, a value of 1 is assigned to the expression. If the value of the 
second expression or term is less than the value of the first, a zero value is 
assigned. 


Given the expression A+B>C, if the expression A+B has a greater value than the value of 
C, the assembler assigns a value of 1 to the expression. If the value of C is greater than the 
value of A+B, a zero value is assigned. 


Since the value of a relational character or logical expression is arithmetic, the expression 
may be used as a term in an arithmetic expression. 


Operator priority is shown in Table 27—2. 


Table 27—2. Operator Priority 


| Operator | Hierarchy | 





Examples: 
LABEL AOPERATIONA OPERAND 
] 10 16 


: &ARK SET ‘ANIM! 
2.1 &NUM SET 6 


1¢ The SET symbol &ARK is assigned the value of ANIM. 


2. The SET symbol &NUM is assigned the value of 6. 
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27.1.5. SETA Statement 


The SETA statement assigns an arithmetic value to a variable symbol that was declared by 
an LCLA or GBLA statement. 


The format of the SETA statement is: 





A OPERATION A OPERAND 


ls a set symbol declared by either LCLA or GBLA. 


SETA 
Defines the operation. 


Is a valid SETA term or an arithmetic combination of valid SETA terms. 
A valid SETA term is: 
= a self-defining term; 


= avariable symbol with an arithmetic value; or 


=  acharacter value consisting of one to eight decimal digits. 


The arithmetic operators used in writing SETA expressions are +, —, *, and /. The 
expression may not begin with an operator. Two operators or two terms may not succeed 
one another. 


The rules of precedence for the evaluation of a SETA arithmetic expression are the same as 
stated in Table 27—2. The value of a SETA expression may range from —223 to 223—1. 


When the SETA symbol is used in an arithmetic expression, the arithmetic value of the 
symbol is substituted for the symbol. If the SETA symbol is used in another context, the 
arithmetic value of the SETA symbol is converted to an unsigned decimal integer with 
leading zeros removed. This decimal value is then substituted for the SETA symbol. If the 
value of the SETA symbol is zero, a single zero is substituted. 
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Examples: 
LABEL AOPERAT IONA OPE RAND 
1 10 16 
1.] &ART SETA 5 
2.{ &LOC SETA 7 
3.1 SHER SETA &ART+ELOC 


1. The SETA symbol &ART is assigned a value of 5. 
2. The SETA symbol &LOC is assigned a value of 7. 


3. The SETA symbol &HER is assigned a value of 12. 


27.1.6. SETB Statement 


The SETB or set Boolean value statement may be used to assign a binary value of zero or 
one to a variable symbol which was declared by an LCLB or GBLB statement. The format of 


the SETB statement is: 





A OPERATION A OPERAND 


Is a set symbol declared in either LCLB or GBLB. 


SETB 
Defines the operation. 


Is a valid logical expression that must be enclosed in parentheses or a O or 1 
enclosed in parentheses. 
The logical expression in the operand field may have a value of either O (false) or 1 (true), 
and the set symbol specified in the name field of the set statement is assigned the resultant 
binary value. The logical expressions may consist of a single term or logical combination of 
terms. 
The permissible terms are: 


= ~a SETB arithmetic relational expressions; 


= = ~=a SETB character relational expression; and 
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& = =a SETB symbol. 


The SETB logical operators that may be used to combine the terms are AND, OR, and NOT. 
The logical expression must not contain two terms in succession. Two operators may appear 
in succession if the first operator is either AND or OR, and the second operator is NOT. Only 
the operator NOT is allowed prior to the first term of the expression. 


A SETB arithmetic relational expression consists of two arithmetic expressions connected 
by a SETB relational operator. A SETB character relational expression consists of two 
character strings connected by a SETB relational operator. The SETB relational operators 





are: 
m NE 
Not equal 
=» EQ 
Equal 
e LT 
Less than 


® » LE 


Less than or equal 
= GT 

Greater than 
me GE 


Greater than or equal 





The arithmetic expression that may be used as a term in the SETB arithmetic relational 
expression is defined under the SETA statement. The rules under the SETC statement 
define the format of the character string that may be used in a SETB character relational 
expression. If two character strings are of unequal length, the shorter will always compare 
less than the longer, regardless of actual value. The maximum length of character strings 
that may be compared is 127 characters. 


In writing SETB expressions, the SETB relational or logical operators must be preceded and 
followed by at least one blank or other special character. The relational expression may be 
optionally enclosed in parentheses. 


& The procedure for evaluating a SETB expression is: 


a Each term (SETB symbol, SETB arithmetic expression, or SETB character expression) is 
evaluated and given a value of either 1 (true) or O (false). 





Da ge ce a a a ee See Se et 





UP-8061 Rev. 3 SPERRY UNIVAC OS/3 
ASSEMBLER 





= ~=6Evatuation is from left to right. The weight of the logical operators is: 


OR = 1 
AND= 2 
NOT= 3 


Therefore, NOT is performed prior to AND, and AND is performed prior to OR. 





lf a SETB variable symbol is used in the operand field of a SETA or DO statement, or in an 
arithmetic relation (in either a SETB or AIF term), the binary values O and 1 are converted to 
the arithmetic value +O and +1. 


If the SETB variable symbol is used in the operand field of a SET statement, the value 
substituted is dependent on the context. In an arithmetic expression, +1 or +0 are 
substituted. In a character expression, the character values 1 and O are substituted. 


Examples: 


LABEL AOPERATIONA OPERAND 
] 10 16 





A a tc a a tN tN oa a 





= nae a A a 


1.! SCONT SETB (L'sTO EQ 4) 
2.| &EXP SETB (1) 


1. If the expression L’&TO EQ 4 is true, the symbol &CONT is assigned a value of 1; 
otherwise, it is assigned a value of 0. 





2. The symbol &EXP is assigned a value of 1. 


27.1.7. SETC Statement 


The SETC statement may be used to assign a character value to a variable symbol that was 
declared by an LCLC or GBLC statement. 


The format of the SETC statement is: 





A OPERATION A OPERAND 





Is a set symbol declared by either LCLC or GBLC. 
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SETC 
Defines the operation. 
Is a valid SETC operand. 
A SETC operand must be a character expression. (See 27.1.8.) 
The maximum length of the value that may be specified for a SETC symbol is eight 


characters. If more than eight characters are specified, only the left-most eight characters 
are used by the assembler. 


Examples: 
LABEL AOPERATIONA OPERAND 
| 10 16 


1.) STYPE SETC 'SsAID!' 
2.1 &CITY SETC 'CINN! 


1. The symbol &TYPE is assigned the value of &AID. 


2. The symbol &CITY is assigned the value of CINN. 


27.1.8. Character Expressions 


A character expression is either a character string, a character substring, or a concatenation 
of strings or substrings. Character expressions are used as the operand of a SET or SETC 
statement or as terms in a SETB, SET, AIF, or DO relational expression. Any character string 
is considered to be greater in value than any shorter character string. A character 
expression may have a length of up to 127 characters. 


27.1.9. Subscripted SET Symbols 


Subscripted SET symbols may be defined as both global and local SET symbols. The local 
SET symbols previously defined were all nonsubscripted SET symbols. Subscripted SET 
symbols provide you with a convenient way to use a SET symbol plus a subscript to refer 
to many binary, arithmetic, or character values. The subscript may be any arithmetic 
expression that is allowed in the operand of a SETA statement in the range of 1 to the 
specified dimension. The subscripted SET symbol consists of a SET symbol immediately 
followed by a subscript enclosed in parentheses. 


A SETA or SETB operand permits only five levels of parentheses. 
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The following are valid subscripted SET symbols: 


&INPUT(30) 
&B45723(&A1) 
&A6B9(2+&B1) 


The following are invalid subscripted SET symbols: 


&AB No subscript 
(300) No SET symbol 


27.1.9.1. Defining Subscripted SET Symbols 


To use a subscripted SET symbol, you must write in a GBLA, GBLB, GBLC, LCLA, LCLB, or 
LCLC instruction with a SET symbol immediately followed by an unsigned decimal integer 
enclosed in parentheses. The number of SET variables associated with the SET symbol is 
indicated by the decimal integer and is called the dimension. Every variable associated 
with a SET symbol is assigned an initial value that is the same as the initial value 
assigned to the corresponding type of nonsubscripted SET symbol. If a subscripted SET 
symbol is defined as global, the same dimension (decimal integer) must be used with the 
SET symbol each time it is defined as global. 


The maximum dimension of 255 can be used with a SETA, SETB, or SETC statement. A 
subscripted SET symbol may be used only if the declaration was subscripted, while a 
nonsubscripted SET symbol may be used only if the declaration had no subscript. 


27.2. BRANCHING 


The sequence of processing macro source code statements may be altered by branching. 
The assembler provides for conditional and unconditional branching. 


27.2.1. Sequence Symbols 


A sequence symbol is used to define a branch destination point. A sequence symbol may 
appear in the label field of any statement that does not contain a symbol or a set symbol, 
except for a macro prototype statement, a local or global symbol declaration statement (LCL, 
LCLA, LCLB, LCLC, GBL, GBLA, GBLB, GBLC), or MACRO, PROC, NAME, ICTL, or ISEQ 
statement. 
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A sequence symbol is written in the following form: a period followed by at least one 
alphabetic character followed by up to six alphaunumeric characters. The following are valid 
sequence symbols: 

D 

.D3 

.BRNCPNT 


When a sequence symbol is written in the label field of a macro instruction, statement, and 
the prototype (MACRO format) or PROC statements (PROC format) for that macro definition 
that contain a variable symbol in their label fields, the sequence symbol does not replace the 
variable symbol. 


27.2.2. Unconditional Branch (AGO) 


The unconditional branch (AGO) statement unconditionally alters the sequence of source 
statement processing. The format is: 


A OPERATION A OPERAND 





where: 


AGO 
Defines the operation. 


S$] 
Is a sequence symbol. 


+So 
Is a sequence symbol defined in a source code statement. 


The label field of the AGO statement may contain a sequence symbol. AGOB or GOTO may 
be used in lieu of AGO in the operation field. The sequence symbol in the operand field is 
the symbol of the next statement to be processed. Branching forward or backward from the 
AGO statement is permitted. 


When an AGO statement is used in a macro definition, the sequence symbol specified in the 
operand field must appear in the label of another statement in that macro definition. 
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Examples: 
LABEL AOPERATIONA OPERAND 
] 10 16 
1. AGO STOP 
2.1 .BRANCH AGO . BUG 


1. An unconditional branch is made to another statement in the source code labeled 
.STOP. 


2. An unconditional branch is made to an instruction labeled .,BUG somewhere else 
in your program. Notice a sequence symbol is used in the label field. 
27.2.3. Conditional Branch (AIF) 


The conditional branch (AIF) statement conditionally alters the sequence of source 
statement processing. The format is: 


A OPERATION A OPERAND 








where: 
S$; 
Is a Sequence symbol. 
AIF 
Defines the operation. 
(b) 
is a SETB logical expression enclosed in parentheses. 
+82 


Is a sequence symbol defined in a source code statement. 


The label field of the AIF statement may contain a sequence symbol. AIFB is permitted in 
lieu of AIF in the operation code field. 


Any logical expression permitted in the operand field of a SETB statement (27.1.6) is valid in 
the operand field of the AIF statement except a O or a 1 enclosed in parentheses. The 
sequence symbol in the operand field must be written immediately after the parenthesis 
terminating the logical expression. 














UP-8061 Rev. 3 SPERRY UNIVAC OS/3 27-17 
ASSEMBLER 





If, after the logical expression has been evaluated, the condition is true (a value of 1), you 
branch to the statement specified by the operand. If the condition is false (a value of 0), 
the statement in the source code following the AIF statement would be the next statement 
to be processed. Branching either forward or backward from the AIF statement is 
permitted. When an AIF statement is written in a macro definition, the sequence symbol 
specified in the operand field must appear in the label field of another statement within 
that macro definition. 


Examples: 
LABEL AOPERAT ft ONA OPERAND 
| 10 16 


; AIF (6BRO NE @).SIS 
2.) IF AIF (L'sTO EQ L'&FROM) .END 


1. If the value of the symbol &BRO is zero, the next statement to be processed is &IF. 


2. If the length attributes of the symbols &TO and &FROM are equal, a true (1) 
results and a branch is made to a statement in the source code labeled .END. 


27.2.4. Define Branch Destination (ANOP) 


The define branch destination (ANOP) statement is provided to facilitate branching. If a 
branch is necessary and no statement within the source code supplies the branch 
destination in its label field, an ANOP statement can be coded to provide a label to which to 
branch. The format is: 










A OPERATION A OPERAND 








eee \ 
LABEL 






where: 
Ss 
Is a sequence symbol. 
ANOP 


Defines the operation. 


The label field must contain a sequence symbol. 


When the label field of a statement which is desired as a branch destination point already 
contains a symbol or variable symbol, the branch destination is indicated by preceding the 
statement by an ANOP statement. 
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LABEL is an acceptable synonym for ANOP in the operation field. 





Example: 
LABEL AOPERATIONA OPE RAND 
1 10 16 
AIF (eTYPE NE L) .DEST 


. DEST ANOP 
&STATE SETC ‘PENN! 


If the Boolean expression in the AIF operand is true, a branch is made to the ANOP 
statement with the label .DEST. Since no operations are performed by ANOP, control 
passes immediately to the following statement, a SETC whose label field is already 
occupied by the variable symbol &STATE. 


27.2.5. Macro Definition Exit (MEXIT) 


The macro definition exit (MEXIT) statement is used when it is necessary to process only 
one section or operation of a macro definition rather than the entire macro definition. This 
statement indicates to the assembler that the processing of a macro definition should be 
terminated before ending normally with a MEND statement. 


The format of the MEXIT statement is: 





A OPERATION A OPERAND 


When MEXIT is used, the assembler terminates processing the macro definition and 
processes the statement in the source program following the macro call instruction that 
called the macro definition containing the MEXIT. A coding example of the MEXIT statement 
is included in 27.3.1. 


27.3. ERROR MESSAGES AND COMMENTS 


PNOTE or MNOTE statements are used to generate error messages or comments in a macro 
definition or in source code statements. 
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& 27.3.1. MNOTE Message Statements (MNOTE) 
A MNOTE message statement is used to generate an error message. It indicates how 
dangerous the error is or generates a comment that supplies information. A MNOTE 
statement is used in a macro definition or in source code statements. 


The MNOTE statement source code statement format is: 







AOPERATIONA OPERAND 





unused 


BY 
- 8 


nD 
-~ 


=€- 5-2 


. 


This format can be used to specify a message enclosed in apostrophes, a comma followed 
by a message enclosed in apostrophes, a severity code followed by a message, or an 
asterisk followed by a message. In all cases, the message is printed in the assembly listing 
source code. The severity code indicates the danger of the error that occurred. The severity 
code is a decimal value of zero to 255. 


a If you want to indicate a severity code of 1, you leave a blank space (A) followed by the error 
message enclosed in apostrophes. An asterisk used as the severity code indicates that the 
message following it is informational and not an error. Any of these specifications causes 
the message to be printed in the assembly listing. Also, MNOTE lines are flagged as errors 
and listed in the diagnostics portion of the assembly listing if they do not have an asterisk in 
operand 1. Messages which are preceded by an asterisk are not flagged or listed in the 
diagnostics because they are not errors. 


Variable symbols can be used as operands in a MNOTE statement. 





The following example contains a MNOTE statement that generates a message in the 
source code of the assembly listing, and causes the line of code to be flagged in error. The 
error also is listed in the diagnostics portion of an assembly listing produced by this code. 


Example: 

LABEL AOPERATIONA OPERAND 

1 10 16 
MACRO 
MOVE &A,&B,&C 
AIF (sA GT O AND &A LT 257) .TAG 
MNOTE ‘INVALID LENGTH SPECIFIED! 

© MEXIT 
.TAG MVC &B(sA) ,&C 


MEND 
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27.3.2. PNOTE Message Statements (PNOTE) 


A PNOTE message statement is used to generate an error message or a comment. A PNOTE 
statement is used in a macro definition or a source code statement. 


The PNOTE source code statement format is: 






A OPERATION A OPERAND 


unused 






In this format, there are two operand fields. In the first field, you can specify an asterisk to 
indicate that the message is informational and not an error; or you can specify a character 
expression containing up to six characters. The second operand field contains the message. 
It can contain up to 79 characters. Regardless of the choice you make for the first operand, 
the message is printed in the assembly listing source code. If it does not contain an asterisk 
as operand 1, a PNOTE statement is flagged as an error and listed in the diagnostics portion 
of the assembly listing. If there is an asterisk in the first operand field, the line is not flagged 
or listed in diagnostics. This is done because the asterisk indicates that the message is not 
an error. 


Variable symbols can be used as operands in a PNOTE statement. 


27.3.3. Comments Statement 


A comments statement written within a macro definition causes the assembler to generate 
comments on the output listing. This type of comments statement is written with an asterisk 
in column 1 of the assembler coding form followed by the comment. 


A special form of the comments statement also is available for use within macro definitions. 
It is used to include comments in a macro definition that are not to be generated in the 
output listing. This comments statement is written with a period in column 1 of the 
assembler coding form, followed by an asterisk (*) in column 2, followed by the comment. 


Neither comments statement form can be created by substitution for variable symbols. 
Substitution for variable symbols is not performed on comment lines. 


Examples: 
LABEL AOPERATIONA OPERAND 
| 10 16 
MACRO 
GEN 


ba 


THIS COMMENT WILL BE GENERATED ON THE LISTING 
.* THIS COMMENT 1S FOR INTERNAL USE, NOT GENERATED 
MEND 
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@ 27.4. REPETITIVE CODE GENERATION 


A section of code can be generated one or more times. The statements DO and ENDO 
specify the code you want and the number of times you want it to be generated. 


27.4.1. Define Start of Range (DO) 


The define start of range (DO) statement defines the starting point of the code and the 
number of times it is to be generated. The format is: 










A OPERATION A OPERAND 


[&varisymb] 


where: 


&varisymb 
Is an optional variable symbol. 





DO 
@ Defines the operation. 


Is a valid SET expression (27.1) written in a macro definition. 


The expression in the operand field indicates the number of times the source code 
statements following the DO statement are produced in the object code. All lines of coding 
appearing between a DO statement and its associated ENDO statement (27.4.2) are 
generated. The value of the expression in the operand field may be any value from O to 
223—1. If the value of the expression is negative, the DO statement is flagged and ignored 
(that is, treated as if the value has been 1). 


The set of statements between the DO statement and its associated ENDO statement are 
said to be within the range of the DO statement. Any valid source code statement may be 
within the range of a DO statement including other DO statements with their corresponding 
ENDO statements. DO statements may be nested up to 10 levels. 


A variable symbol may be declared in the label field of the DO statement. The rules for 
writing. variable symbols are described in Section 26. When the variable symbol in the 
label field is specified, it is used as a counter for the number of times a set of lines within 
the range of a DO statement has been generated. The value of this variable symbol is 1 
the first time through the set of statements; 2 the second time through; and so forth. It is 
referenced in the same manner as a SETA symbol (27.1.5). An example of a DO statement 


@ is shown in 27.4.2. 





De ee 
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27.4.2. Define End of Range (ENDO) 


The define end of range (ENDO) statement is used to indicate the end of the range of a DO 
statement. The format is: 





A OPERATION A OPERAND 





DO and ENDO statements must be paired. For every DO statement, there must be an ENDO 
statement to define the end of the range. 





Examples: 
LABEL AOPERATIONA OPERAND 
| 10 16 
1.] &DOI DO 5 
25 ; 
3. 
4, , 
5. ENDO 
6. : 
7. e 
8.| &D02 DO 10 
9. 
10. 
VW, ‘ 
12.| &D03 DO 3 
13. ‘i 
14, . 
15.) 6D04 DO 5 
16, 
17. 
18, ‘ 
19, ENDO 
20. ENDO 
2), : 
22. ENDO 


Lines 2, 3, and 4 are produced in the assembler output five times. 


Lines 9, 10, 11, 21, and the lines produced by the operation of the DO directives on 
lines 12 and 15 are produced in the assembler output 10 times. 


Within each of the 10 sets of code produced by the DO directive on line 8, lines 13, 14, 
and the lines produced by the operation of the DO directive on line 15 are generated in 
the assembler output three times. 





Within each of the 30 sets of code produced by the DO directives on lines 8 and 12, 
lines 16, 17, and 18 are generated in the assembler output five times. 
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27.4.3. Conditional Assembly Control Counter (ACTR) 

You use the ACTR statement to limit the number of AGO, AIF, GOTO, AGOB, AIFB, and GO 
statements that may be processed by the assembler either within a macro or within the 
source program. 


The ACTR statement source code format is: 








A OPERATION A OPERAND 


SETA expression 


The ACTR statement must be written immediately following the local and global symbol 
declarations in either the source program or in a macro definition. There can be a separate 
ACTR statement in the source program and in each macro definition. 


The value of the expression in the operand field may be any positive value from 1 to 223—1. 
The value specified in the operand field causes a counter to be set to that value. This 
counter is decremented by 1 for each AGO, AGOB, or GOTO statement that is processed for 
each AIF or AIFB statement whose evaluation resulted in a true condition and for each time 
that the range of a DO statement is generated. 


If the counter is zero prior to decrementing, the following occurs. If a macro is being 
processed, its processing and that of any macros above it in a nest are terminated. The next 
statement to be processed is in the source code following the macro instruction that 
initiated the nest. !f the source code is being processed (outside a macro definition), an END 
directed is generated. The assembly continues with only that portion of the program 
generated thus far. 


If an ACTR statement is not written, the value of the counter is 4096;,o. 


27.5. ATTRIBUTE REFERENCES 


The assembler assigns certain attributes to symbols and macro call operands that you may 
refer to in conditional assembly statements. These attributes are type (T), length (L), scale 
(S), integer (I), count (K), and number (N). 


You can specify attributes in conditional assembly statements to control logic, which in turn 
can control the sequence and contents of the inline expansion code generated from model 
statements. Each kind of attribute has a specific purpose, which determines when you use 
it. The format of an attribute reference is as follows: 


LABEL A OPERATION A OPERAND 


[symbol] conditional 
assembly 


operation 


‘ symbol 
code &symbo! 





ZxA7-OrH 
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The attribute notation (T, L, S, I, K, or N) denotes which attribute of a symbol or parameter 
you are using. The symbol or parameter is a reference to the data or field which possesses 
the attribute. The operation code must be a conditional assembly operation code except 
when you are using the length attribute. (See 4.4.5. for a discussion of the use of length- 
attribute references in program source code.) 


The origin of an attribute value is always either a symbol or a parameter. Table 27—3 gives 
the restrictions for using a symbol or parameter as the reference to obtain a particular data 
attribute. Whether a symbol or parameter can be used in an attribute reference depends on 
where it is referenced. If an attribute reference is made in macro source code (from inside a 
macro definition), a symbol may be referenced for any data attribute except K or N. A symbol 
cannot be used in a count or number attribute reference in macro source code because, 
when K or N is used inside a macro definition, the only data that can be referenced is an 
operand field in the macro instruction call. Any one of the valid attributes can be acquired 
for a symbol or &SYSLIST. A SET symbol and the system variable symbols listed in Table 
27—3 can only be used in the T and K attribute references when in macro source code. You 
can get all but K or N attributes of a symbol in program source code by using the symbol in 
the attribute reference. Macro instruction operands cannot be referenced from program 
source code so a symbolic parameter or a &SYSLIST cannot be part of an attribute reference 
in program source code. However, a SET symbol and the system variable symbols listed in 
Table 27—3 can be used in an attribute reference in program source code. 


Table 27—3. Valid Attribute Reference Applications 


[Attribute 
BOoaoo _ 


ST 
0 


J &SYSNDX, &SYSPARM, 
and &SYSTIME 
[oe 
ees a es sa 
CCT ee 
&SYSJDATE, and &SYSTIME 
V= valid application 














Macro 
source 
code 










< 








Program 
source 
code 





i &SYSJDATE, &SYSECT, 
: 
| J SET symbol 
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There are two requirements that must be met before using symbols in attribute references. 
First, the symbol must appear either in the operand field of an EXTRN directive used outside 
of a macro or in the label field of at least one assembler directive or instruction outside a 
macro. Second, there must not be any variable symbol in the source line in whose label field 
the symbol appears. In regard to the call operand attributes, you must abide by the same 
criteria in addition to the following. The operand must be a symbol and it may not be one 
generated by variable symbol replacement. The attributes of the operand are really the 
attributes of the symbol itself. A nested call operand may be a symbolic parameter whose 
attributes are then the same as the corresponding outer operand. You cannot use a length 
attribute if the type attribute is J, M, N, O, T, or U (see 27.5.1.). 


Since a call operand may be a sublist, you can also refer to attributes of a sublist or each 
individual parameter in the sublist. When you refer to these attributes, they will be assigned 
the same value as the first parameter in the sublist. 

You can refer to attributes on conditional directives both inside and outside of macros. 
Symbols that appear in the label field of instructions generated by a macro are not 


assigned attributes. If a SET symbol appears in the operand entry of a macro instruction, 
attribute information is not provided and the operand may not be accessed as a Sublist. 


27.5.1. Type Attributes 


You can use the type attribute to test for the characteristic of the operand or symbol. This is 
done by writing a T followed by the symbol or symbolic parameter to be tested. This can also 
be used in SETC directive operand fields or as character expressions in SETB and AIF 
directive operand fields. Table 27—4 summarizes the type attributes and the circumstances 
under which they are produced. 


Table 27—4. Type Attributes of Symbols (Part 1 of 2) 


Symbol Length 
T : 
Type A address Implied Full-word 
constant 
Binary constant Implied or Not applicable 
explicit 
Character tmplied or 
constant explicit 
cE “ 
Full-word Implied 
floating-point 
constant 














Not applicable 









Double-word 
floating-point 
constant 


Double-word 







Full-word 


Full-word 










constant 


Full-word Implied 


fixed-point 
Explicit 


Fixed-point 
constant 


Not applicabie 
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Table 27—4. Type Attributes of Symbols (Part 2 of 2) 


Symbol Length ‘ 
t 
Definition Specification men 
Half-word Implied 
fixed-point 
constant 


Machine instruction Half-word 


Control section Not applicable Double-word 
name 


Floating-point Not applicable 
constant 


Packed decimal Implied or Not applicable 
constant explicit 


o@ 
Unaligned address Explicit Not applicable 
constant (A, S, V, or Y) 
: 








Type S address Half-word 
constant 
T External symbol Not applicable Not applicable 
@ Type not available Not applicable Not applicable 


Vv Type V address Full-word 
constant 


Hexadecimal Explicit or Not applicable 
constant implied 


Type Y address Half-word 
constant 


Zoned decimal Explicit or Not applicable 
constant implied 








This type attribute is produced only for macro instruction operands. 


Type cannot be assigned. It is produced for inner and outer macro instruction operands that 

cannot be assigned any other attribute, as well as for literals appearing as macro instruction operands, 
symbols appearing in the label field of LTORG, ORG, or EQU directives, symbols appearing more than 
once in a source statement tabel field, and symbols appearing in the label field of DC or DS 

directives containing expressions or variable symbols in the modifier subfields. The latter is 

true even if the modifier subfield expression consists solely of self-defining terms. 


©O 





en  eeeEEEEEEOeeeEeEEEE——— EE EEOEEEeeEeeeeee eee TaD TT aT TTT ETT Tne TEn een EN NENT 
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27.5.2. Length Attributes 


You can reference the length attribute by writing an L’ followed by the symbol or parameter 
whose attribute you want. The length attribute has a numeric value, which refers to the 
number of bytes assigned by the assembler to a data field. If the length-attribute value is 
required for conditional preassembly processing, the symbol you specify in the attribute 
reference must appear in the label field of a statement in open source code. The operand 
field of that statement must contain a self-defining term. 


The length modifier or length field must not be coded as a multiterm expression because the 
assembler does not evaluate this expression until assembly time. 





LABEL AOPERATIONA OPERAND 
1 10 16 
DATA DC FL7'7E+9' 


When the length attribute is used in conditional assembly statements, it can be specified 
only within an expression. Examples: L’&P(4),L’&VARY(1,2),L’&SYSLIST(5). These could be 
written in conditional statements such as: 


AIF (L'eP(4) LT 6P(3)).PE 
&LBL SETA L'sTAG 
DO L'! sNAME=6 


An L’ cannot be generated directly by a macro/proc; it can be done indirectly as follows: 


LCLC &A,&B 
&A SETC 12! 
&B SETC a 
MVC 6A.(&BEA) ,X 


After generation this would result in: 


MVC Z(L’Z),X 
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27.5.3. Scale Attributes 


You can reference scale attributes of variable symbols by coding an S’ followed by the 
desired symbol. Scaling attributes are available only for labels of statements defining fixed- 
point constants. This restricts them to H, F, D, E, P, type Z, type K, and type G constants in 
the OS/3 assembler. The scaling attribute is the value you have assigned for the scale 
modifier of a fixed-or floating-point constant. This modifier is an integer used to assign a 
number of bits in an unnormalized constant for the fractional portion of the constant. For 
example, the scale modifier of a DC statement such as HF8A’—19.788’ would be 8, since it 
is specifying 8 bits for the fractional part of the number. For decimal type constants the 
scaling attribute is the number of decimal digits to the right of the decimal point. 


The following examples illustrate typical usages of scale attributes: 


LABEL AOPERATIONA OPERAND 
1 10 16 

AIF (S'sS(1) EQ S'eS(2)).S) 
&SCALE SET S'sP(1) 

DO S'SVARY 6 


27.5.4. Integer Attributes 


An integer attribute can be written with an I’ followed by the symbol you wish. An integer 
attribute is computed from length and scaling attributes and is thus also applicable only to 
a symbol which is the label of a statement defining a fixed-point or floating-point constant 
(F, H, D, E, P, type Z, type K, and type G). A fixed-point integer attribute is equal to 8 times 
the length attribute, minus the scaling attribute, minus 1 (I'=8*L—S’—1). For floating 
point, you obtain the integer attribute, multiplying by 2, and subtracting the scaling 
attribute |’=2*(L’—1)—S’. Typical fixed-point constants and their computed integer 
attributes are: 


HLFWRD De HS4'97.65' 
FULLWRD DC FS12'47.8959' 
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A half-word fixed-point constant (H) would have a length attribute of 2 (L‘=2) and a scale 
attribute specified as 4 (S‘=4). Therefore, the integer attribute would be (8x2)—8—1=7. A 
full-word fixed-point constant would have a length of 4 (L‘=4) and a scale attribute specified 
here as 12 (S‘=12). The integer attribute in this case would be (8x4)—12—1=19. 


Some floating-point constants and their computed integer attributes are: 


LABEL AOPERATIONA OPERAND 
1 10 16 

FLTHFWRD DC ES3'64.495! 

FLTFLWRD DC DS6'17.99.2' 


Since E is a floating-point full word, its length attribute is 4 (L’=4). The scale attribute is 
specified to be 3 (S‘=3). Thus, the integer attribute is 2 (4—1)—3=3. When we have a 
floating-point double-word constant (D), its length attribute is 8 (L‘=8). The scale attribute is 
shown to be 6. We can then compute the integer attribute to be 2(8—1)—6=8. For decimal 
constants, the integer attribute is the number of decimal digits to the left of the decimal 
point. 


27.5.5. Count Attributes 


You can use the count attribute of a call operand to reference the number of characters in 
the operand, excluding commas. This attribute is determined after substitution of any 
variable symbols; that is, it uses the replacement characters rather than the variable 
symbol to determine the count attribute. You can use the count attribute in SETA or DO 
operand fields, and in relational expressions of SETB and AIF operands that are within a 
macro. 


If the operand selected is a sublist, the count attribute will include the parentheses and 
commas within the sublist. Examples using count attribute references in statements are: 


OPCT SETA K'SSYSLIST(1) 
&GBLB SETB (K'sP(3) NE @) 


AIF (K'&P(2) EQ @) .NG 


UP-8061 Rev. 3 SPERRY UNIVAC OS/3 27—30 
: ASSEMBLER 


27.5.6. Number Attributes 


For call operands you can also reference the number of operands in an operand sublist. You 
reference the number attribute by writing an N’ followed by the symbol or parameter whose 
attribute you want. This number is equal to 1 plus the number of commas separating or 
indicating the omission of operands in the sublist. This attribute is available in SETA, DO, 
SETB, or AIF directives. 


Examples of number attribute usage are: 


LABEL AOPERATIONA OPERAND 
] 10 16 
&NUM SETA N'éP 
sCOUNT  SETB (N'SSYSLIST NE 2) 
AIF (N'SSYSLIST NE 3).ERRI 
DO N'&SYSLIST-2 
DO N'&P>2 


If an operand is not a Sublist, the number attribute is 1. If an operand is omitted, its value is 
0. 


The following is an example showing all the attribute references available, along with the 
related constants and local directives that a SET directive requires in a program 
environment. 


PROC &PARAM, 1} 
DATTR NAME 
*DISPLAY ATTRIBUTES OF MACRO INSTRUCTION OPERAND 
-* THIS COMMENT IS NOT GENERATED 


LCLA &5Q,610,&KQ,ENQ,ELQ 
LCLC &TQ 

&10 SETA 1'g PARAM (1) 

&SQ SETA S'&PARAM(1) 

&KQ SETA K'& PARAM (1) 

ENQ SETA N'SPARAM (1) 

&lQ SETA L'sPARAM(1) 

&TQ SETC T'&PARAM (1) 
DC C'sPARAM(1)' THIS IS THE OPERAND 
pc Y (&LQ) LENGTH ATTRIBUTE OF PARAM 
pC Y(&KQ) COUNT ATTRIBUTE OF PARAM 
DC Y¥(&10). INTEGER ATTRIBUTE OF PARAM 
DC Y¥(&SQ) SCALE ATTRIBUTE OF PARAM 
DC ¥(&NQ) NUMBER OF OPERANDS IN SUBLIST 
oc C'eTQ! TYPE ATTRIBUTE OF PARAM 
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28. Organization of Listing 


28.1. HEADER LINES 


The assembly listing produced by the OS/3 assembler consists of five sections, each with 
its own headings. The five sections are: 


m PREFACE 

Lists of options and assembler identification. 
= CODEDIT 

Object code and source code entries 
= = EXTERNAL SYMBOL DICTIONARY LISTING 
m CROSS-REFERENCE LISTING 


= DIAGNOSTIC LISTING 


28.2. PREFACE 


The first section or preface section identifies the assembler variant (if any), its version and 
update number, and the time and date of the assembly. The formats: 


UNIVAC OS/3 ASSEMBLER 
DATE yy/mm/dd TIME — hh.mm 


The preface also lists parameters indicating the assembler options selected in the job 
control stream, if any. 
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28.3. CODEDIT 


In this section, source coding is printed beside the object code generated for it. The first 
header line in this section contains the operand field used in the TITLE statement. The 


header, except for the page number, will be blank. The headings in the second line are 
shown in Table 28-1. 


Table 28—1. CODEDIT Listing Content 


Second Heading Line Field Contents 
Assembler address of the object code in hexadecimal. 


OBJECT CODE 






Contains the object code produced from the source statement. 
This field is left-justified and is in hexadecimal. Machine 
instructions are printed in the format: 












mmmmmmmmmnmm 


Constants are printed in the form: 






















c——C 


ADDR1 Contains the effective address in hexadecimal for the first 
operand of an instruction referencing main storage. 
ADDR2 Contains the effective address in hexadecimal for second 
operand of an instruction referencing main storage. 


LINE Contains the sequential record number in decimal. If the 
statement is macro-generated, each line of generated code 
indicates its nest level in the leftmost portion of the 
column containing the line number. This macro level indicator 
is an alphabetic character (A through Z) that represents the 
nest level at which the coding was generated. If more than 26 
levels are nested, the indicator wraps around from Z to A. The 
line counter columns can record 10,000 lines of code (from O 
to 9999). If line 10,001 of code is nested, the line number 
will wrap around from 9999 to OOOO. The next level indicator 
enables you to see the nest level on any line of source code. 













SOURCE 
STATEMENT 


Contains the source program statement. The listing also contains 
any macro-generated statements, following the source statement 
that called it. The assembly listing also prints embedded macro or 
proc call lines when one macro or proc calls another into the 
program. The embedded lines contain the original keyword and 
positional parameters supplied by the caller. 


Although a sequence heading does not print in the assembly listing, you are permitted to 
have a sequence field that does print. Lines of code generated by a macro or proc call line 
retain any sequence number they had when they were originally coded. That is, the original 


sequence number is printed in the assembly listing on the same line as the generated 
statement. 
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28.4. EXTERNAL SYMBOL DICTIONARY LISTING 


This section is optional; you can request its omission at assembly time. Entries are 
generated in the external symbol dictionary listing for named and unnamed section 
definitions (defined by CSECT statement), entry points (defined by an ENTRY statement), 
external symbols (EXTRN statement and type V constants), and common sections (COM 


statement). A description of the information which is contained in this section is given in 
Table 28—2. 


Table 28—2. External Symbol Dictionary (ESD) Listing Content 


Second Heading Line Field Comments 
SYMBOL Contains the symbol that caused the ESD entry to be generated. 
TYPE 


Defines the type of entry: 

























CSECT Section definition (CSECT or START) 


Symbol appeared in operand field of 
ENTRY statement. 





External reference (symbol appeared in 
EXTRN operand field or defined as type 
V address constant) 


Common control section definition 


Two-digit external symbol identification number (in hexadecimal) 
of item. 





ADDRESS Contains the address of the symbol in hexadecimal for ENTRY 
ESDS, the starting address of the control section for CSECT 


and COM items, and blank for EXTRN ESDS. 


LENGTH 





Contains a hexadecimal value which is the assembled length 
(in bytes) of control on common section. Blank for ENTRY 
and EXTRN ESD items. 
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28.5. CROSS-REFERENCING LISTING 


This section is optional, you can request its omission at assembly time. When this section is 
included, each symbol in the object program is listed in alphanumeric sequence with the 
statement number of the statement defining it, and the statement numbers of all references 
to it. Also included in the data for the symbol are the length attribute of the symbol and the 
value assigned to the symbol in the assembly. 


The first heading line of every page contains the following: 

CROSS REFERENCE 
The information on each page of the cross-reference listing appears in one column on the 
left half of the page. If more space is needed, the assembler prints a second column of 
cross-reference data on the right half of the page. Each column has a heading line 


followed by one or more data lines. The formats of the column heading and data lines are 
given in Table 28—3. 


Table 28—3. Cross-Reference Content 


Second Heading Line Field Comments 
SYMBOL Symbol to which cross-reference data pertains. 


LENGTH 
















Length (in decimal) of data associated with symbol (i.e., implied 
length of symbol). 




















Hexadecimal value of symbol. 


DEFN Statement number of statement in which symbol is defined. 


(Actual line 
numbers of 
reference) 


May contain from O to 5 entries of the form nnnndA, where nnnn 
is a statement number, and AA represents two blanks. Each entry 
represents a statement number of a fine in which the symbol 

is referenced. Succeeding lines will be used as necessary to 

list all the references or duplicate definitions. Leading zeros 

are suppressed. 












Printing of the symbol cross-reference listing is in double-column 
format. Continuation occurs from the bottom of the left-hand 
column to the top of the right-hand column and from the bottom of 
the right-hand column to the top of the left-hand column on the 
next page. The last page of the listing may contain any part of a 
partial page. 
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28.6. DIAGNOSTIC LISTING 


Statements containing errors are flagged and appear in the diagnostic listing. The 
diagnostic listing follows the assembly listing and contains a detailed accounting of any 
errors that occurred in the assembly. The listing contains the line number of the statement 
in which the error occurred, the error code, and a message indicating the cause of the 
error. The messages are listed in the order in which they occurred. A diagnostic listing is 
optional and can be suppressed by using the PARAM statement (Appendix F) with the 
LST=ND option in its operand field. The PARAM statement also provides the LST=DBG 
option, for debugging a macro definition. 


When a macro definition is retrieved from a library, those of its statements that contain 
errors are listed and flagged immediately after the END statement. To obtain a listing of 
the macro statement containing the diagnostic error, you must use the LST=DGB option. If 
the macro definition is part of your source program, actual source statements are flagged 
if they contain errors. Each error is then listed in the diagnostic listing. 


The first heading line contains the following: 


DIAGNOSTICS 


The format of the second heading line and the data line contents are given in Table 28—4. 


Table 28—4. Diagnostic Listing Content 


Field Contents 


May contain from 1 to 10 entries of the form nnnnddA, where 
nnnn represents a statement number of a tine in which the error 
occurred and AA represents two leading blanks. Leading zeros 
are suppressed. 


ERROR CODE Error code of the error in form annn. 
MESSAGE An actual error message giving details about the error. 


After the listing of the diagnostics, the assembler prints the total number of statements that 
were in error as follows: 


Second Heading Line 


STMT 



















nnnn STATEMENTS FLAGGED IN THE ASSEMBLY — yy/mm/dd hh.ss 


The final error statement message is also displayed on the console upon completion of the 
assembly. This lets you know immediately if there are any diagnostic errors in your source 
program. 


28.7. EXAMPLE OF ASSEMBLY LISTING 


Section 29 contains a sample assembly listing. 


_ 


Y 














PART 7. PROGRAMMING TECHNIQUES 
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29. Job Control Procedures 


29.1. HOW TO RUN A JOB 


To assemble, link edit, and execute your program, you must tell the computer what you 
want it to do for you. You assign peripheral devices and then request other programs and 
routines for use in your program. Job control is your means of communicating with the 
computer. Job control procedures are designed to enable you to get your program into the 
computer in the most efficient way. These procedures are similar to macro definitions. They 
generate a series of job control statements by using one calling line of code. This section 
includes the job control procedures you need to assemble your program into an object 
module, to link-edit your program into a load module, and finally, to execute it. There are job 
control procedures available for many other functions but they are not discussed here. The 
minimum number of job control statements needed to run your program are provided. For 
additional information on job control, refer to the current version of the job control user 
guide, UP-8065. 


When using a multisectioned program or unfamiliar instructions, assemble the program and 
correct any syntax, addressability, or other errors. Then, add the job control cards needed to 
link-edit and execute, and resubmit the job. Assemble your program and store the object 
module in a private library for execution at another time or store the object module and link 
it to another object module for combined execution. The current version of the system 
service programs user guide, UP-8062, contains information about link-editing and how to 
create and access files of stored information. 


29.2. INTRODUCING THE SOURCE DECK 


To assemble your source program into an object code module, you need to surround your 
source code deck with job control statements. The job control statements needed to 
introduce the source deck are discussed in 29.2.1 and 29.2.2. 
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29.2.1. JOB Control Statement 


The first job control statement in your deck is the JOB control statement, which assigns a 
unique name to your job. It is the only required parameter, as you can see from the 
format. See the current version of the job control user guide, UP-8065, for an explanation 
of the other parameters. 











P 
//{symbol] JOB jobname At | [,min] [,max] [4% rt] [,max-time] [,(op-list-1,...,op-list-n)] 
NOACT 
[,acct-no] [,nXm] | , NORE iaoa 





The jobname can have up to eight alphanumeric characters. The name you specify on the 
JOB control statement has no bearing on the name you assign on the START card (see 17.5) 
within your assembly program. The jobname parameter distinguishes one job from another. 
Use a unique name, since only one job can be scheduled for processing by the operating 
system under a name. (If two jobs have the same name, the second job would replace the 
first job.) 


29.2.2. OPTION Job Control Statement 


Following the JOB control statement, you can include an OPTION job control statement to 
cause a program dump at the end of your assembly listing. There are three kinds of dumps 
you can request, depending on the parameter you choose: 


LABEL AOPERATIONA OPERAND 
| 10 16 


1.|// OPTION DUMP 
2.|// OPTION JOBDUMP 


3-|// OPTION SYSDUMP 


These dumps are explained in the current version of the system service programs user 
guide, UP-8062. When a program terminates normally, the OPTION job control statement 
alone does not produce a dump. You must have a corresponding DUMP or SNAP card 
within your assembly program. DUMP and SNAP are supervisor macros created to dump 
portions or all of your assembly program. DUMP and SNAP are explained in the current 
version of the supervisor user guide, UP-8075. 


If your program terminates abnormally and you've included an OPTION job control 
statement, you'll get a dump following the assembly listing. 
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If an OPTION job control statement is not present in the control stream, the DUMP macro 
instruction acts as an EOJ macro instruction. The OPTION job control statement must also 
be in the job step in which you want the dump to occur. For example, if you assemble, link- 
edit, and execute your load module, and you want the dump to occur when you execute your 
load module, you place the OPTION job control statement in the job step that executes your 
load module, not in the one that assembles or link-edits. 


29.3. ASSEMBLE; ASSEMBLE AND LINK-EDIT; OR ASSEMBLE, LINK-EDIT, AND 
EXECUTE 


You can assemble, link-edit, and execute your program in steps or do it a// at once. Each of 
these functions requires a different job control procedure (jproc) call statement. You can use 
any one of these jproc call statements, depending on what you want to do: 


= ASM — Assembles your source deck. 
= ASML — Assembles and then link-edits. 


# ASMLG — Assembles, link-edits, and then executes the generated load module. 


29.3.1. Assemble (ASM) 


When you assemble, you create and name (either directly or indirectly) an object module. 
Errors incurred during assembly are flagged and listed on the printout in the diagnostics 
following the assembly listing. Once you have an error-free assembly, you are ready to 
execute. To execute, you must add the job contro! statements to your deck (and ASM jproc 
call statement) that link-edit and execute your program. Or, you can replace the ASM jproc 
call statement with the jproc call statement to assemble and link-edit (ASML) or assemble, 
link-edit, and execute (ASMLG). The latter approach is suggested. It is more practical to let 
the prewritten job control procedures do the work rather than having to keypunch the 
additional cards. If you do not use ASML or ASMLG jprocs, you will have to consult the 
current version of job control user guide, UP-8065 for the additional cards needed. 


Remember, the object module you produce during assembly is not saved (unless you say 
so with a parameter). After the assembly is complete, the object module is removed from 
the temporary job $YSRUN file. If you want to save it for later use, you must store it in a 
system library, or a library of your own. The librarian portion of the current version of 
system service programs user guide, UP-8062, describes system and user libraries. 
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The format of the jproc call statement that generates only an assembly follows. Except for 
the OUT parameter, the format also applies to the ASML and ASMLG statements 


discussed in 29.3.2 and 29.3.3. 


lun [,dest] 
N_ [,dest] 
[dest] 


(vol-ser-no, label) 
(RES) 
,IN=< (RES, label) 


//{symbol}] AASMA PRNTR= 





(RUN, label) 
(* label) 


(vol-ser-no, label) 
(RES, label) 


_ ) (RUN, label) 
Urls (*, label) 
(N) 





vol-ser-no-1 ,label-1 
RES, label-1 

RUN, label-1 

* label-1 





vol-ser-no-1 ,label-1 
RES, label-1 

RUN, labef1 

* label-1 





LsT= option 
’ (opt-1,...,opt-n) 





vol-ser-no, label 
(RES, label) 
(RUN, label) 

(* label) 





vol-ser-no-2,label-2 





RES, label-2 & 
RUN, label-2 

* label-2 

N 





vol-ser-no-2,label-2 
RES, label-2 

RUN, label-2 

* label-2 
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The symbol field of the ASM jproc call statement is an optional field. There is no space 
between the // and the symbol. Normally, your input (the source module) is in the form of 
punched cards. But, possibly, you may have stored the source module in a library. The 
symbol field supplies the name of the source module (one to eight alphanumeric 
characters). (The symbol field is only needed when you use the IN parameter.) 


If no name is specified on the START directive, ASMOBJ is assigned. You can have only one 
unnamed assembly (the default, ASMOBJ) within a job unless all other assemblies are 
continuations of the first. For example, if performing two individual assemblies within the 
same job, proceed as follows: 


LABEL AOPERATIONA OPERAND 
| 10 16 


enema ai: en tiie eens nt ee tt A ee a NN A NE A AT EN AY A A RN PS Ee eRe 


// JOB COMSTOR 

// ASM 

/$ 

PROGA — START M4 


END 
/ * 
// ASM 
/$ 
PROGB START ) 


END 
/[* 
/& 
// FIN 


In this example, the first assembly is named PROGA, and the second is named PROGB. The 
jobname is COMSTOR. When you use the IN keyword parameter, you must also use the 
symbol field. (This is discussed when the IN keyword parameter is discussed.) 


The keyword parameters of the ASM jproc call statement are optional. The shaded areas 
indicate the default values generated if you do not use the parameter. You can use 
statement continuation to contain all the parameters you want to specify. Following are 
examples of correct and incorrect coding: 


Correct Example: 


// JOB ASSEMBLE 


//PROGNM ASM PRNTR=21, IN=(DSC1,USSRC) , 
//\ OUT=(DSC2,USOBJ), 
//2 LIN=(DSC1,USMAC1,DSC2 ,USMAC2) 


/& 








UP-8061 Rev. 3 SPERRY UNIVAC OS/3 29-6 
ASSEMBLER 


Incorrect Example: 


You cannot break a parameter specification. The keyword and its value must be on the same 
card. You can not code the IN parameter as follows: 


LABEL AOPERATIONA OPERAND 
1 10 16 


ee ne etc se RE A NE A NN A LT A A A A AE A AAA =o Ma it 


// JOB ASSEMBLE 
//PROGNM ASM PRNTR=2 1 





This coding would cause an error. To continue on another card you need a nonblank 
character (we used X) in 72, and, in the next card, a // in columns 1 and 2 followed by a 
number in column 3 as shown in the correct example. The column 3 numbers must be in 
ascending order in the deck, in the range of 1 through 9, or they can all have the same 
number. If there are two continuation cards, as shown in the correct example, the first card 
cannot be //2 and the second card //1. But it could be //2 and //2. 


The parameter definitions are as follows: 


PRNTR= 
Allocates a specific printer for the assembly listing. 
N 
If you specify N, the device assignment set for the printer is not generated 
by the jproc. Instead, the device assignment set for the printer is manually 
inserted by the user in the control stream (prior to the placement of the 
jproc call). This allows for the creation of specific load code and vertical 
format buffers (the LCB and VFB job control statements) by the user. 
For example: 
//DVC 26 // VFB LENGTH=66,DENSITY=6 
// LFD PRNTR 
// ASM PRNTR=N 
NOTE: 
When this parameter is used, the file name for the device assignment set 
for the printer must be PRNTR. 
lun 
If you want a logical unit number other than 20, you must specify the logical 
unit number associated with the printer you select. 
20 


If you specify 20 as the logical unit number, you will get the next available 
printer. This parameter is optional because 20 is the default value. 
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dest 


lf you spool the printed output and want to send it to a device at a remote 
site, you use this parameter to specify the device’s 1- to 6-alphanumeric- 
character destination identifier as it is defined by remote batch processing. 


You only use the IN keyword parameter when the source program is not on 
cards. If you have stored your unassembled program on a disk, you use the IN 
parameter to retrieve it for assembly. When using this parameter, you must have 
the name of the source program you are retrieving in the symbol field of the 
ASM jproc call statement. The options are: 


(vol- 


ser-no, label) 

Specifies the volume serial number and the file identifier where the source 
module is located. For example, it could be on a disk whose volume serial 
number is DSC1. The disk is assigned that number. On the disk, the source 
program, named PROGNM, is stored in a library called USSSRC. To 
assemble the source program, specify the IN keyword parameter to define 
the input. (This parameter must be used when making source corrections via 
the SKI, REC, and SEQ statements; see F.2.) 


LABEL AOPERATIONA OPERAND 
| 10 16 


// JOB ASSEMB2A 
//PROGNM ASM IN=(DSC1,USSRC) 


(RES) 


Indicates you want to retrieve a source program from the system resident 
device (SYSRES) in the source library file (SY$SRC). 


(RES, label) 


Indicates you want to retrieve your source program from SYSRES. But it is 
not in $SYS$SRC; it is in a file identified by the label. 


(RUN, label) 


Indicates you want to retrieve a source program from the volume containing 
the job’s run library file (SYSRUN). The label is the file identifier. 


(*, label) 


Indicates you want to retrieve a source program from a cataloged file. The 
label is the file identifier, which is all that is necessary to identify the file to 
the system. 
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OUT= 
You use this parameter to store assembled object modules in a library other than 
the job’s SYSRUN file to save your assembly. Remember that the ASM jproc only 
stores your program until the job is complete. To permanently save an object 
module, you must put it somewhere with the OUT parameter. This also 
generates a PARAM OUT job contro! statement. The options are: 





(vol-ser-no, label) 
Specifies the volume serial number and file identifier where you want to 
store the object module. It is assumed that this file has been already 
allocated. If it is not, you have to supply a device assignment set to allocate 
this file. 


(RES, label) 
Indicates that you put your object module on SYSRES, but you didn’t use the 
reserved $Y$SRC file; you named your own file. The label is the file 
identifier. 


(RUN, label) 
Indicates you put the object module on the volume containing the job’s 
SYSRUN file in the file identified by label. 


(* label) 
Indicates you want to store the object module in a cataloged file. The label is 
the file identifier, which is all that is necessary to identify the file to the 
system. 





(N) 
Indicates you do not want the object module stored in your own file or 
retrieved from SYSRUN. 


LIN= 
You can use the macro library file (SYSMAC) to store the macro definitions or 
you can use a nonsystem library. The LIN keyword parameter identifies the 
library you want searched. If you do not specify this parameter, $Y$MAC is 
searched. The options are: 


(vol-ser-no-1,label-1[,vol-ser-no-2,label-2]) 
Provides the volume serial numbers and file identifiers. You can specify up 
to two volumes and files where macros are stored. $Y$MAC is searched if 
the desired macros are not found elsewhere. 


(RES, label-1[, RES, label-2]) 


Specifies two library files to be searched for macros; both are files on 
SYSRES. 


(RUN, label-1[, RUN, label-2}) 
Specifies two library files to be searched for macros; both are files on the 
volume containing the job’s run library file (SY$RUN). 
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(*,label-1[,*,label-2]) 
Specifies two library files to be searched for macros; use this format when 
the files are cataloged, so you need only specify the file identifiers. 


(N) 
Indicates that no macros should be retrieved. 


COPY= 


Identifies library files containing stored source programs that are to be copied 
into another source program. You can specify two volumes and two files. If you 
do not specify this parameter, $YS$SRC is searched for any source programs 
named in an assembler COPY directive. This parameter works with the COPY 
directive, which names the source programs you want to copy into your program. 
The options are: 


(vol-ser-no-1,label-1[, vol-ser-no-2,label-2]) 
Provides the volume serial numbers and file identifiers. You can specify up 
to two volumes and files where source programs are stored. 


(RES, label-1[,RES,label-2]) 
Specifies two library files containing stored source programs; both files are 
on SYSRES. 


(RUN, label-1[, RUN, label-2]) 
Specifies two library files containing stored source programs; both files are 
on the volume containing the job’s run library file (SYSRUN). 


(* label-1[,* ,label-2]) 
Specifies two library files containing stored source programs; you use this 
format when the files are cataloged, so you need only specify the file 
identifiers. 


(N) 
Specifies that no source programs should be copied. 


LST= 
Alters the normal assembly listing and generates a PARAM LST job control 
statement. If you do not use this keyword parameter, the assembly listing 
contains a source, object, cross-reference, and diagnostic listing. You can specify 
LST options in either of two ways: 


The options are: 


option 
Specifies a single option. 


(opt-1...,opt-n) 
Specifies more than one option. The parentheses are required. 
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N 
Specifies that no assembly listing is produced. 

NC 
Specifies that no cross-reference listing is produced. 

ND 
Specifies that no diagnostic listing is produced. 

NR 
Specifies that the cross-reference listing is to contain only symbols that 
each have at least one reference. The NC option, if specified with NR, 
always overrides it. 

DBG 


Specifies a proc or macro debug mode feature within the OS/3 assembler. 
When the feature is selected, the output listing shows the following: 


= Results of the expansion of any proc or macro called within the user 
program, including any conditional assembly directives processed as the 
result of the expansion itself. Source coding (constants, directives, and 
instructions) is listed twice and shows any appropriate substitutions. 
Any statements causing error diagnostics show the exit line in error. 





= A proc or macro which produces error diagnostics at the time it is 
encoded is listed following the END directive; e.g., system errors. A proc 
or macro is encoded once, but may be called multiple times. 


= If an error is detected at both expansion and encoding time, it appears 
two or more times. Errors detected only at encoding time appear once 
following the END directive. 


# §@A‘l lines flagged (regardless of their order of appearance) are shown in 
the diagnostic summary list. Lines flagged at encoding time may or may 
not be flagged at expansion time. 


When this feature is not selected, any errors detected during proc or macro 
expansion may not show the exact line in error, but rather the vicinity of the 
item which is flagged. 


SCR1= and SCR2= 
The assembler needs two scratch work areas to perform its calculations. 
Normally, the SYSRES device is used for one file and the volume containing the 
job SYSRUN file for the other file. This is what is generated by default. But, you 
can use a different volume if desired. 


SCR1=vol-ser-no and SCR2=vol-ser-no 
Specify the volume serial numbers of the work files. The default for SCR1 is 
SYSRES, and the default for SCR2 is the volume containing the job's 
SYSRUN file. 
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ALTLOD= 
Identifies the file from which the assembler will be loaded. 


(vol-ser-no,label) 
Provides the volume serial number of the pack from which the assembler 
will be loaded and the name of the file that contains the assembler. 


(RES, label) 
Indicates that the assembler is to be loaded from the file identified by label 
on SYSRES. 


(RUN, label) 
Indicates that the assembler is to be loaded from the file identified by label 
on the volume containing the job’s run library file (SYSRUN). 


(*, label) 
Indicates that the assembler is to be loaded from a cataloged file specified 
by label. 


(RES,SYSLOD) 
Indicates that SYSRES is the volume from which the assembler will be 
loaded and that $Y$LOD is the file that contains the assembler. This is the 
default. 


29.3.2. Assemble and Link-Edit (ASML) 


When you assemble and link-edit your program, you create and name an object module and 
a load module. The load module is temporarily stored in the job’s $YSRUN file. The job is not 
executed. You only assemble and link-edit without executing if you are referencing 
something in your program that is defined in another program. For example, you may have 
external references (EXTRN), data management routines (DTFPR), supervisor routines 
(DUMP), etc. At link-edit time, cross-referencing between object modules is completed and 
loose ends are tied together. If you can link-edit without error, you are one step closer to 
completing the job. 


The load module is saved temporarily in the job $YSRUN file, thus enabling all separate 
object modules to communicate while the job is being run. Once the link edit is complete, 
the load module is removed from $Y$RUN. The load module can be stored permanently as 
discussed in the current version of the linkage editor portion of the system service programs 
user guide, UP-8062. It is important to realize you are using more main storage, for a longer 
period of time, when you assembly and link than when you just assemble. When you use 
the ASML jproc call statement, you cannot use the OUT parameter to define an output 
library and save the generated object module. 
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29.3.2.1. ASML Jproc Call Statement 


The format of the ASML jproc call statement generates an assembly and then automatically 
link-edits the object module. The options shown are described in 29.3.1.1. Again note that 
the OUT option is not included. 








“tun [dest] 
[symbol] AASMLA PRNTR=/ N [,dest] 
[,dest] 
(vol-ser-no, label) 
(RES) 
N= (RES label) ; 
(RUN, label) 
(* label) 
vol-ser-no-1,label-1 vol-ser-no-2,label-2 
RES, label-1 RES, label-2 
LIN= RUN, label-1 , RUN, label-2 
* label-1 * label-2 
vol-ser-no-1,label-1 vol-ser-no-2,label-2 
RES, label-1 RES, label-2 
RUN, label-1 RUN, label-2 
Pony * label-1 * label-2 
N N 








option 
ast=} (option-1, ... , opt-n ea) 


aa a 
[ma 


vol-ser-no, label 
RES, label 
,ALTLOD= RUN, label 
* label 
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This jproc call statement is useful when you are still testing your program, since it lets you 
see the output of your job without reserving a file for it. Once the job is executing properly, 
you can allocate a file and store the load module by using the linkage editor. This jproc call 
statement is also useful for infrequently run jobs. 


The functions and use of the linkage editor are explained in the current version of the 
system service programs user guide, UP-8062. There also is a jproc for executing the 
linkage editor, just as there is one for executing the assembler. This jproc call allows you to 
do more with the generated load module than either the ASML or ASMLG jprocs, such as 
storing the load module in a library. (This does not mean you cannot store your load module 
when you use either the ASML or ASMLG jproc call statements; it only means you cannot 
do it by the jproc call itself). You also can use the LINKOP linkage editor control statement 
but this involves more coding, and the jprocs are designed to reduce coding. The jproc call 
statement for the linkage editor is included in the current version of the job control user 
guide, UP-8065. 


29.3.3. Assemble, Link-Edit, and Execute (ASMLG) 


When you use the ASMLG jproc call statement, you create and name both an object 
module and a load module, temporarily store it in the job SYSRUN file, and then execute it. 
The load module is stored in the job $YS$RUN until execution of the job is completed. You 
cannot use the ASMLG jproc call when the system has the shared data management 
feature because job control must first scan the load modules in SY$LOD for this feature. 
The GO option associated with the ASMLG jproc call cannot be used. If you use the ASM 
jproc call with a separate LINK jproc call or the ASML jproc call and want to execute the 
program using the shared data management feature, you must provide a separate EXEC 
statement. 
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29.3.3.1. ASMLG Jproc Call Statement 


The format of the ASMLG jproc call statement generates an assembly, creates a load 
module, and executes your program. The options shown in this format are described in 
29.3.1.1. Notice, however, that the default value of the ALTLOD parameter is 
RUN,$YSRUN when using the ASMLG jproc call statement. The OUT keyword parameter 
does not apply to the ASMLG jproc call statement; only to the ASM jproc call statement. 


jun [,dest] 
[symbol] AASMLGA_ | PRNTR= in ise 
20, [dest] 


(vol-ser-no, label) 
(RES) 
IN= < (RES, label) 












(RUN, label) 
(*,label) 
vol-ser-no-1,label-1 vol-ser-no-2,label-2 
RES, label-1 RES, label-2 
LIN= RUN, label-1 RUN, label-2 
; * Jabel-1 ’ ) * label-2 
N 
vol-ser-no-1 ,label-1 vol-ser-no-2,label-2 
RES, label-1 RES, label-2 
ie RUN, label-1 RUN, label-2 
FOOENS * label-1 ") * label-2 
N 
‘ust={ option 
| (option-1,... , opt-n) 
vol-ser-no 
[son 


[ sono-{ "fae \ ] 
vol-ser-no, label 
RES, label 







,ALTLOD= RUN, label 
* label 
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NOTE: 


Calling the ASML or ASMLG jproc more than once in a single job may create 
unpredictable results. As called by either of these jprocs, the linkage editor includes all 
object modules currently residing in the job $YSRUN file, even those modules generated 
by ASML or ASMLG jprocs called earlier in the job. In this way, you may accidentally 
include object code that has no place in your intended program. To avoid this problem you 
should: 


7. call only one ASML or ASMLG jproc per job; or 


2. assemble individual object modules separately using the ASM jproc, then link the 
modules together with one of the linkage editor jprocs described in the current 
version of the system service programs and job control user guides; these linkage 
editor jprocs give you more control over the generated load module. 


29.4. START-OF-DATA JOB CONTROL STATEMENT (/S) 


A Start-of-data job control statement must precede the first card of the source program or 
any macros being submitted with the source program. 


LABEL AOPERATIONA OPERAND 
| 10 16 


// JOB MYPROG 
// ASM 





END 
/* 
29.5. FOLLOWING THE SOURCE DECK 


Following the END card in the source deck, you need job control cards to tell the computer 
that you have completed part or all of your job. 


29.5.1. End-of-Data Job Control Statement (/*) 
An end-of-data job control statement follows the END directive of the source program. 


// JOB MYPROG 


// ASMLG 

/$ 

PROGNM START g 
END 





UP-8061 Rev. 3 





SPERRY UNIVAC OS/3 29—16 
ASSEMBLER 


29.5.2. End-of-Job Control Statement (/&) 


An end-of-job control statement terminates the job which was started by the last JOB 
control statement. It indicates that all job steps have been completed. 


LABEL AOPERATIONA 


1 10 16 

// JOB COMSTOR 

// ASM 

/$ 

PROGA START ) 
END 

/* 

// ASM 

/$ 

PROGB START g 
END 

/* 

/& 

// FIN 


OPERAND 


le ae he A NN A A A A PN 


29.5.3. Terminate-the-Card-Reader Job Control Statement (//FIN) 


A terminate-the-card-reader job control statement ends a card reader operation. This 
statement follows the end-of-job contro! statement as shown in the coding form in 29.5.2. 


29.5.4. Setting the UPSI Byte 


If any errors are detected in your program while it is being assembled, the assembler sets 
the User Program Switch Indicator (UPSI) byte according to OS/3 system standards to 
indicate the type of errors that occurred. 


UPSI Byte Setting 





Bit O 1 (X‘80') 
0 
Bit 1 1 (X‘40’) 


Meaning 


Catastrophic errors were detected in the source program 
that prevented completion of the requested function. An 
object module was not generated. 


No catastrophic errors were detected. 

Serious errors were detected that may have affected (but 
not prevented) the completion of the requested function. 
An object module was generated but the results could be 
unpredictable. 


No serious errors were detected. 
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Bit 2 1 (X‘20’) Diagnostic errors were detected but the completion of the 
requested function was not affected. The source program 
contains a legal but potentially undesirable situation. An 
object module was generated. 


0 No diagnostic errors were detected. 
NOTE: 
In the event of a program check, the UPSI byte setting X’80’, in combination with a 
supervisor macro (STXIT), provides continuation to the next job step rather than complete 
termination of the job stream. The job step that resulted in the program check is cancelled 


and a dump is produced. For further details about STXIT, see the supervisor user guide, 
UP-8075 (current version). 


29.6. SUMMARY OF JOB CONTROL PROCEDURE 


The following card deck and sample printouts demonstrate the difference in an output 
listing when the same source program is assembled; assembled and link-edited; and 
assembled, link-edited, and executed in three separate steps. 


29.6.1. Assembly 


The following source desk requests an assembly: 


my 
source 
program PROG START 0 


// JOB ASSEMBLE 





The listing produced by the assembly source deck is as follows. The headings are explained 
in Section 28. 


UNIVAC SYSTEM OS/3 ASSEMBLER VERTSO32Z6 
DATE- 75/08/27 TIME- 19,51 


ASSEMBLER CONTROL STATEMENTS ENCOUNTERED AND PROCESSED AS FOLLOWS 


as 


EXTERNAL SYMBOL DICTIONARY PAGO 1 
SYMBOL. TYPE. FSIO. ADDRESS. LENGTH. 


PROG CSECT OF oooa00 oa01c4 
OUT EwTrRY G1 oco00so0 

ouTC ENTRY O1 go0072 

DPSCOMO EXTRN 2 
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ASSEMBLER 
LOC. OBYECT CODE ADDR1 ADDR2 LINE SOURCE STATEMENT OS/3 ASM 75/08/27 @& 
000000 1 PROG START 0 
o0u000 0560 2 BEGIN BaALR 6.0 
ocoo02 3 USING #56 
ooo002 47FO 6010 00v12 4 BRANCH B e+l6 
O00006 C1C2C 3C44Ca040s0 s oc CLB*ABCD* 
QOOOOE CSC6C 7?Cc8 6 ec CLO‘EFGH® 
000012 D203 6068 600C uUcvOA OOOOE 7 mvc BRANCH+6249,BRANCH12 
8 OPEN OUT 
000018 90 CNOP Q,4 
000018 4510 6O1E 00020 1u+ BAL 1,9428928 
ocooic 80 lie oc X*eD*? 
000010 000040 12¢ oc AL3Z0UTa 
acod2o 0A26 li+ svc 36 ISSUE SY¥C 
000022 D207 6OEA 6008 GOGEC 00006 14 MvC BUFZ68,BRANCH*H 
1s PuT Our 
oces 28 16+ oc OYt0a SET ALIGNMENT 
000028 5810 6OFE 00100 37+ t 1,#AX0UT@ LOAD RIS, FILENAME ADDRESS 
Ocoo2c 9220 1031 00031 18+ avi HOTIaeX*20" SET FUNCTION CODE 
000050 S8FO 1034 00634 194 L 15,52%,1a@ LOAD ADDR OF COMMON 1/0 
000039 OSEF 20+ BALR 14515 LINK TO COMMON 
22 CLOSE OUT 
0000 36 22+ Oc OYs0a 
000036 5810 6OFE 00100 23¢ tL 1 sHAZ0UTS@ LOAD RIS, FILENAME AQDRESS 
OGGO 3A OA2T 244 svc 39 ISSUE SVC 
‘ 25 EOu 
00G0 3c 204 s OH 
0000 3C GAIA 27+ S¥C 26 
26 OUT OTFPR BLKSIZE#16 ,LOAREAIB BUF, SAVAREARSAVE 
2948 OTFPR EXEC93S 12719774 
Q0003E 0700 30+ CnoP G,& DOUBLE WORO BOUNDARY ALIGNMENT 
ocoo 40 32+0UT Eau * 
32+ ENTRY OUT 
000040 00600 GatoC0c0000 33+ oc 7TF*0* 
OcOOSC O6ESE 340408040 344 oc CL7°GUT* DCSNME 
000063 40 354 Oc cli" * 
000064 afoa Boe oc H'G* OPSMFLG 
000066 gfoo 374 oc H°O* DPSsPUB 
38 2 PRALD NOT SPECIFIED. STANDARD LINE ACVANCE SET TO 1. 
39 *,RECORG FORMAT KEYWORD NOT SPECIFIED. SET TO FIXUNB. 
OcoOo6s ooCaOcON sue oc AztCa OPSPOYV 
ooo906¢ 0006 Sle oc H°O* GPSRLA 
OCOO6E O4FO 2 pc XL2"OSFG* OPSOTF 
o0007c FO : ase oc cLito* 
900071 oG Ras pe XLi°GG* DPSREQS 
o0co 72 @5*OUTC FOU * ERROR FLAG LABEL 
aoe ENTRY OUTC 
gcoo72 oacu 47+ oc H*C*® DPSEFG 
occo 74 do000K0U age Oc AZOPSCOMOa OPSIOCS 
age ExTRN DPSsCOMO 
$u @,NG ERROR ROUTINE. ERRORS KETURN INLINE. 
Pace 2 
LOC. ORJECT CODE ADDR1 ADDR2 LINE SOURCE STATEMENT : OS/3 ASM 75/08/27 
000078 gnogood) Sie oc AZ0a@ DPSERR 
Qqua7c oO See oc HLI*O® OPSCwIC 
000070 cOcGdEC 530 Oc AL33BUFe DPSCw10 
Sue ExTRN BUF 
oou08c0 onoo 55e oc HO DPSCWIF 
00u082 0000 See oc H°G* OPscula 
000084 09 574 oc HLI"O* DPSREC 
aouo8s o39 Sae a YLIZO@ OPSIRGE 
0009 86 04 59+ oc YLI2929 UPSF6) 
ocoos7 on 60+ bc YL1%028 DPSFG2 
on0088 4) 61+ oc YLj%6%a GPSFG3 
acoua8s9 09 62+ oc YLIzda OpsFG6s 
0C30 8a 00 63+ oc YLizO@ OPSF65 
0000 8B o4 64+ oc YLIZ4@ OPSRFM 
oojJo8c 0010 65% oc H*O16* OPSBKS 
OCOOBE gO 664 oc YLi20@ OPSCCS 
GOOIOBF O9 674 oc YLIZ%9@ DPSPRA 
acoo90 00009 00u 68+ ec AzQd OPSBAS 
000094 00030 0a0 69% DC AZXSAVIA DPSSAV 
To EXTRN SAVE 
000098 OooGOGCO Tle oc AZ0A OPSSAVR 
oco0 9c Ve Os F 
go00 a0 73 SAVE Os Cl?2e 
OO000E8 74 os F 
OcocEC 7S BUF Os Z2LI6 
ooo0 90 Te €ND BEGIN 
oco100 90000049 7 sazouta 
CROSS-REFERENCE PAGE 1 
SYMBOL LENGTH VALUE LINE 
BEGIN 04032 000390 09002 0376 
BRANCH 00004 O00002 c0004 3607 o0u7 uO14 
BUF 00016 OUQUEC 20075 vOlS 0053 vBOb4 
OPSC ONO 0048 
out 00001 o0oo04a 20032 yO12 9017 uvO23 3032 0077 
ouTc 03001 OGCa72 Goo4S 0096 
PROG 90001 GUu0v09 GoDnD) 
SAVE 00072 G50Ga0 00073 ao069 oo70 


WO STATEMENTS FLAGGED IN THIS ASSEMBLY -7TS/UB/2T = 19,.53- 
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29.6.2. Assembly and Link-Edit 


The following source deck requests an assembly and link-edit: 


my 
source 
program PROG START 0 
Z // JOB ASSMBLL | 


The listing produced by this deck is as follows: 





UNIVAC SYSTEM OS/3 ASSEMBLER VER7S0326 
DATE ~ 75/08/27 TIME- 19.53 


ASSEMBLER CONTROL STATEMENTS ENCOUNTERED AND PROCESSED AS FOLLOWS- 


4s 


EXTERNAL SYMBOL DICTIONARY PAGE 1 
SYMBOL. TYypt. ESI10. ADDRESS. LENGTH, 
PROG Csect ai 0300090 000104 
OUT ENTRY O02 o0c040 
ouTc ENTRY OF a9g072 
OPSCOMO EXTRN O02 
Loc. OBJECT CODE AODR1 AODR2 LINE SOURCE STATEMENT OS #3 ASM 75/08/27 
oaoo a0 1 PROG START G 
o00000 0560 « BEGIN BALR 6,0 
acao02 3 USING *,6 
o00002 47FO 6010 00042 4 BRANCH 8 e*lo 
O00006 CIC2C 3CH4NROeO8D > oc CcCLe*aBcD® 
OOAOOE C5CeC 7Ca b oc CL&°EFGH® 
000012 0203 6008 600C DOO0A OO0GE 7 MVC BRANCH*+8 29a, BRANCHE12 
3 OPEN OUT 
060018 9+ cnop 0,4 
000018 #510 601E o0u20 106 BAL 19 Pezas2e 
acao1c 80 lie oc x*80° 
Gc0010 co0040 lee oc AL3z0UTa@ 
000020 OA26 136 SVC 38 ISSUE SVC 
Gc0022 D207 GOEA 600% GOOEC Ooone 14 mvc BUFZ8@,BRANCH?*S 
15 Pull OUT 
000028 16¢ oc GyxGa SET ALIGNMENT 
0c0028 5810 6OFE oo100 lve L 1,#AR CUTS LOAD RIS, FILENAME ADORESS 
Qcoo2c 9220 1031 6o031 184 Mui 49%1a,X*Z0" SET FUNCTION CODE 
Go00 30 58FO 1034 00034 19% i 15352%,1@ LOAD ADOR CF COMPON 1/70 
6000 345 .OSEF 20 BALR 14,415 LINK TO COMMON 
21 CLOSE QUT 
0000 36 2e* oc GYR08 
000036 5810 6OFE Go1u00 25+ L 1,@ATOUTS LOAD RIS, FILENAME ADDRESS 
OCOO03A OA27 24+ Sve 39 ISSUE SV¥C 
2s €0u 
ooud 3¢ 26+ os OH 
GO00 3C OAIA 27+ svc 26 
28 OUT BIFPR BLKSIZE#36 sIOAREAIBBUF , SAVIRE AGSAVE 
2908 OTFPR EXEC93 12419774 
Go003E 0700 3G¢ CNOP O,8 DOYBLE WORD BOUNDARY ALIGNFENT 
goo0480 31+0UT EQu » 


32+ ENTRY OUT 
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0c09%0 000390 08000000000 33° oc 7F*O* 
OOOOSC O6ESE 3404050480 34* oc CL7°OQUT® DCSNME 
ocgao63 40 35% Oc cum * 
oO000648 Go00 36+ oc H*O* OPSMFLGE 
000066 9005 37+ oc H*G* OPSPUB 
38 @yPRAD NOT SPECIFIED. STANDARO LINE ACWANCE SET TO 2. 
39 *,PECORD FORMAT KEYWORD NOT SPECIFIED. SET TO FIXUNB. 
000068 00000000 0+ Bc AZGa OPSPOV 
a0u06c 0000 ale oc H'O* DPSRLA 
OCOO6E OaFO Ree pc xL2*OSFO* DPSOTF 
000079 FO a3 oc cLi"o* 
oco0071 00 age oc XL1*OG* DPSREQS 
ocou 72 45e0UTC EQu  * ERROR FLAG LABEL 
or ENTRY OUTC 
000072 a000 aT oc H'O* DPSEFE 
0005748 00000900 48+ oc AZ<OPSCOMOs DPSIOCS 
894 EXTRN DPSCOMO 
Su *,NO ERROR ROUTINE. ERRORS RETURN INLINE. 
PAGE 2 
Loc. OBJECT CODE ADDR1 ADOR2 LINE SOURCE STATEMENT OS/3 ASM 75/08/27 
009078 G9000000 Sie Dc A%0d DPSERR 
gooo7c oa S2e Dc HLI*O* OPSCwIC 
003070 9900EC 53+ oc AL3zBuUFe OPscwiD 
54e EXTRN BUF 
a0o0c 80 0000 55¢ oc H°O* DPSCWIF 
Ocd0 32 9000 Soe oc H'O* OPSCw1b 
aoo0 84 oa Sit+ oc HLI'O* DPSREC 
009085 gO 58e bc YLiz0@ OPSIRG 
009086 04 590 oc YLIZ4@a OPSFG) 
009087 OO 60+ oc YL3I3Ga DPSFG62 
ago003e 40 61+ oc YLI<4642@ DPSFG3 
000089 00 62+ oc YL1z0@ OPSFG4 
ocoo 8a 00 63+ Oc YL220@ OPSFGES 
a0oo 4s 04% 64+ oc YLI342@ DPSRFA 
oaogsc 0010 654 Oc H*G16° OPSBKS 
ood0aE gO 66+ oc YL3z0a@ OPSCCS 
0000 aF O09 67+ oc YLIz9@ UPSPRA 
900090 00009000 64+ oc Av0d DPSuAS 
903094 00000 9A0 69+ oc AZSAVE@ OPSSav 
70+ EXTRN SAVE 
00u098 00000000 Tle Oc AzZCa@ DPSSAVR 
d0009C 2 BS F 
0000 AO 73 SAVE DS CL72 
ooooEs ic) Os F 
OoucEC 7S BUF os ZL) 
ooo000 To END BEGIN 
000100 G0000 040 7 #AXOUTS 
CROSS-REFERENCE PAGE 1 
SYMBOL LENGTH VALUE LINE 
BEGIN aos0c2 coou00 o0nD2 a076 
BRANCH 00008 000002 00004 0007 Gov? 95014 
BUF 00016 QOODEC o007S 0029 C053 0054 
DPS$c OMO a08s 
out 90002 900040 00031 0012 0017 OO23 A032 077 
ouTCc ooo00!t OG00T2 GG04S Q0%6 
PROG c0001 G0n000 00001 
SAVE 00072 CaGOAO 00073 0069 0070 
NO STATEMENTS FLAGGED IN THIS ASSEMBLY -75/08/27 19.55- 
*OEFINITIONS DICTIONARY® 
SYMBOL. TYPE. PHASE. ADORESS. SYMBOL. TYPE. PHASE. ADUORESS. SYMBOL. TYPE. PHASE. ADDRESS. 
OPSCOMG ENTRY ROOT 33909090 DPSCOML cnTRY ROOT 90009090 opscom2 <enTay R890T 30000000 
OPscom3 ENTRY ROOT 30300000 DPSCOMS ENTRY Root 90000000 DPSCOMS ENTRY ROOT 009990995 
OPSC OMG ENTRY ROOT aoacoco0 OPSCOMT ENTRY ROOT 00000090 KESALP ENTRY aBS 99000568 
KESRES ENTRY ABS a0o005B8 out ENTRY ROOT 030 048Fo oUTC cNTRY ROOT 39009522 
PRSLOE CSECT ROOT 00000000 PROG CSECT ROOT 00300480 
@ePHASE STRUCTURE®*® HEX BYTES REPRESENTED BY EACH DASH - E 


I Jo *5B4* 
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*e ALLOCATION MAP 00 


LOAD MODULE - LNKLOD SIZE - ON000SB4 

PHASE NAME TRANS ADOR FLAG LABEL TYPE £910 LNK ORS HIAQDR LENSTH OBJ ORG 

tnx Lopoo NODE - ROOT a30)30960 03000583 90900584 

eee START OF AUTO-INCLUDEO ELEMENTS - 

- 03/26/74 01.09 - PRSIOE obu 

PRSLOE CSECT 32 ooao0000 no0009a9 O090098AA 90909000 
DPSCOM7? ENTRY u2 00090006 30009000 
DPsCOMD ENTRY G2 oo005000 oe00n000 
DPSsCcoMml ENTRY vz Ocd0neco 90900000 
DPSCOM6 ENTRY be asucoaa0 oo0000000 
OPscome ENTRY ue oo00n0u0 300909000 
OPSCOMS ENTRY uz o0008cu0 30600005 
DPSCOMS ENTRY uz Gous0000 909000090 
DPSCOM3 ENTRY v2 Oo900000 76300090 

eee END OF AUTO-INCLUOED ELEMENTS - 

- 75/08/27 19.54 - PROG oeu 
PROG CSECT a1 09090460 goo0nsBs 99000104 noo00000 
our ENTRY o1 n90c048FO 790099480 
OUTC ENTRY v1 00030522 39000972 
Quco04B0 


UNIVAC SYSTEM OS/3 LINKAGE EDITOR 


VERO31874 
DATE - 75/08/27 TImEe- 19.55 


CONTROL STREAM ENCOUNTERED AND PROCESSED AS FOLLOWS- 


¥GENERATEO*® LUAOM 
PROG *RUN LIBE MODULE * 
OPSCOMD *AUTO-INCLUDED* 


The definitions dictionary, phase structure, and allocation map are explained in the current 
version of the system service programs user guide, UP-8062. 


29.6.3. Assembly, Link-Edit, and Execution 


The following source deck requests an assembly, link-edit, and execution: 


fe) 







my 
source 


program PROG START 0 


/$ 


//DVC 20 // LFD OUT 


// JOB ASSMBLG 


The listing produced by this service deck is the same as the assembler and link listing, but it 
includes the results of the execution. This program moved letters and printed out the field 
containing ABCDEFGH. 
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30. Example Macro Definitions 


This section gives examples of both PROCs and MACROs. The explanation of these 
examples places the primary emphasis on the macro source code instead of on the resulting 
inline expansion source code. Descriptions of the macro definitions resolve around variable 
parameter replacement and variable inline expansion code caused by conditional assembly 
statements. Each description is accompanied by the macro source code and an example call 
with the inline expansion code. 


30.1. SMALR/LARGR PROC (POSITIONAL PARAMETER 0) 


The following example PROC selects either the smallest or largest of three positional 
parameters submitted in the call instruction. Two different mnemonics are provided for 
indicating whether the smallest or largest value is selected. The call SMALR is used for 
smallest value selection and the call LARGR is used for largest value selection. This PROC is 
a good example of using positional parameter 0. 


PROC Source Code: 


fDMY PROC G84 
SMALR NAME &NH 
LARGR NAME BNL 


AIF (N°ER NE &)CERR Test for 4 parameters. Branch to print error message if untrue. 


EDOMY ZAP ERCP SERE2) Select first value. 
cP G@¢12,€6003) Compare to next value. 
€a(o) #910 BNH or BNL or 
ZaP GHU1),6 863) Select next value. 
cP C#tl),Ee04) Compare to next value. 
Catcod #410 BNH or BNL or 
Zap E811) se oB43 Select next value 
MEXIT 

«ERR MNOTE ‘IMPROPER PARAMETERS=-NO GENERATION! 
END 


inline Expansion Code (smallest value): 


SMALR SELECT, VAL1,VAL2, VAL3 
ZAP SELECT, VALI 

ce SELECT, VAL2 

BNH #710 

zap SELECT, VAL2 

ce SELECT, VAL3 

BNH ee10 

ZAP SELECT, VAL3 
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Inline Expansion Code (largest value): 


LARGR SELECT, VALI,VAL2,VAL3 
Zap SELECT, VAL} 


cP SELECT, VAL2 
BNL #**10 
ZAP —s- SELECT s VAL2 
cP SELECT, VAL3 
BNL #410 


ZAP SELECT, WAL3 


Operand 2 of the PROC statement indicates there are four positional parameters that can be 
passed from the call instruction, and &# is the symbolic parameter that references the 
positional parameters. This PROC requires all four positional parameters from the PROC. 
Otherwise, no inline expansion takes place and the message coded in the MNOTE is printed. 


The AIF conditional assembly statement tests to see whether the four parameters are 
present. Whether the smallest or largest value is selected from the call instruction is 
dependent upon generation of the BNH or BNL instruction in the inline expansion code. This 
is controlled by the ca//-names SMALR or LARGR used in the two NAME statements. 
SMALR implements BNH for positional parameter O and LARGR implements BNL. 


The two model statements referencing positional parameter O (&#(0)) are the instructions 
that determine smallest or largest value selection. The inline expansion code shows that the 
SMALR call instruction generates BNH in place of &#(0) and the LARGR call instruction 
generates BNL. The SMALR call instruction generates BNH in place of &#(O) and the LARGR 
call instruction generates BNL. 


Positional parameter 1 of the call instructions indicates an area to receive the selected 
value. It is referenced in the model statements (&#(1)) in operand 1 of the add instructions 
and compare instructions. Positional parameters 2 through 4 of the call instructions are the 
values to be selected. The model statements that perform the calculations for finding the 
smallest or highest value have references to positional parameters 2 through 4 (&#(2) 
through &#(4)). 


The MEXIT statement ends PROC processing at this point in the PROC, so the message isn't 
printed. The MNOTE is printed only if there aren’t four positional parameters in the call 
instruction. 


30.2. SMALL6/LARGE6 PROC (DO LOOP) 


The following example PROC selects either the smallest or largest of the positional 
parameters in the call instruction, just like the SMALR/LARGR PROC. This PROC broadens 
the usage range by allowing the caller to specify from 3 to 100 values instead of limiting the 
caller to only 3 as did the SMALR/LARGR example PROC. There are two call mnemonics 
provided: the SMALL6 is used for small value selection and the LARGE6 is used for large 
value selection. The two mnemonics are provided via positional parameter O. The 
SMALL6/LARGE6 PROC shows a design using DO loops to provide variable inline 
expansion code. The DO range is determined by the number of values in the call instruction; 
the more values in the cail, the more lines of source code generated. 
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PROC Source Code: 


EDMY PROC &P,100 

SMALLO NAME BNH 

LARGE6 NAME BNL 
BO N*EP>2 

SOMY ZAP EPULIZEPEL2Z) 

ECT 00 N*EP-2 
cP EPCLD,EPCECTA2I Inner DO loop. The instructions CP, BNH/BNL, 
EP(O) £410 and ZAP will be generated the number of positional 
ZAP EPC1L),EPLECTA#23 parameters in the call instruction minus two. 
ENOO 
ENOO 
BO N'EPC3 ~ 
PNOTE *NOGEN* s*MINIMUM OF THREE PARAMETERS REQUIRED® 
ENDO 
END 


Inline Expansion Code (smallest value): 


SMALLO SELECT, VALI, VAL2,VAL3,VALU,VALS 


ZAP 
cP 
BNH 
zapP 
cp 
BNH 
ZAP 
cp 
BNH 
ZAP 
ce 
BNH 
ZaP 


SELECT, VALI 
SELECT, VAL2 
#410 
SELECT, VAL2 
SELECT, VAL3 
#*10 
SELECT, VAL3 
SELECT, VALS 
+10 
SELECT, VAL4 
SELECT, VALS 
*¢10 
SELECT, VALS 


Number of parameters = 6 
\ First inner DO generation 


\ Second inner DO generation DO iteration = 6—2 = 4 


\ Third inner DO generation DO N’&P—2 


t Fourth inner DO generation 


Inline Expansion Code (largest value): 


LARGE 6 SELECT, VALI, VAL2 pVAL3, VAL4, VALS 


Zap 
cP 
BNL 
zaP 
cP 
BNL 
ZAP 
cP 
BNL 
zap 
ce 
BNL 
zap 


SELECT, VAL} 
SELECT, VAL2 
#+10 
SELECT, VAL2 
SELECT,VAL3 
**10 
SELECT, VAL3 
SELECT, VAL4 
*e10 
SELECT, VALS 
SELECT, VALS 
#10 
SELECT, VALS 


1 


2 
j Outer DO processed because number of parameters 
} are more than 2 (DO N’'&P > 2). 


3 


@ 


Operand 2 of the PROC statement indicates that the user can code up to 100 parameters in 
the call instruction while the symbolic parameter is &P. Two mnemonic codes can be used 
to call this PROC, as coded in the label field of the two NAME statements. Each is used to 
implement different BAL instruction codes via positional parameter O (&P(O)). In this PROC, 
positional parameter O is referenced only one time, while in SMALR/LARGR it was 
referenced twice. This is because the inner DO loop generates the required number 
BNH/BNL instructions to process the number of values coded in the call instruction. Of 
course, the inner DO is never processed unless the outer DO is. 
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In order for the outer DO to be processed, there must be more than two positional 
parameters in the call (DO N’&P>2). If there are two parameters or less, a zero is generated 
in the outer DO operand and the DO with the PNOTE is generated. 


A 1 is generated in the operand field of the PNOTE DO because there are less then three 
parameters (DO N‘&PL3), and the message in the PNOTE is generated. The call instruction 
for the SMALL6/LARGE6 example PROC must have a minimum of 3 positional parameters 
and can have a maximum of 100. This gives a range of 1 to 98 values to be tested for the 
highest or lowest value. If you compare this with the SMALR/LARGR example PROC, you 
can see that the SMALL6/LARGE6 PROC provides much more than SMALR/LARGR and 
has only one more line of code. 


30.3. BLANK MACRO (VARIABLE INLINE EXPANSION CODE) 


The following example MACRO blanks (X‘00’) the content of a specified number of bytes. 
There are only two positional parameters that can be submitted with the BLANK call 
instruction, and one is optional. Positional parameter 1 indicates the starting address of the 
area to be cleared, and positional parameter 2 specifies the number of bytes to be cleared. If 
the number of bytes in the area is less than 257, parameter 2 is optional. The BLANK 
MACRO is an example of variable inline expansion code. There are three basic sets of code 
that can be generated from this MACRO. Positional parameter 2 is used to determine which 
set is generated. 


MACRO Source Code: 


MACRO 
EOMY BLANK G8#1,88#2 
LCLA éLAl ; 
DO tN*ESYSLISTS2Z 1 +#(N*ESYSLIST<K}) Error‘check 
MNOTE 7,°IMPROPER PARAMETERS - NO GENZRATION® 
MEXIT 
ENDO 
00 N*ESYSLIST=1 
AIF (L'&#1 GT 2563.81 PAG la pencseeicuae 
cOMy neues Seaeteh positional parameter 2 
oAl MNOTE 6,*LENGTH OF &#1>256 - PARAM: 2 MUST BE USED® me onurted 
MEXIT 
ENDO 
AIF ¢T°GN2 NE *"N*),A2 
GLAl SETA &#2 
comy L 15,-ACEM1) 
00 &#2/256 
xc 6(256,15},0015) Code generated for 
LA 15,256¢015,01 
ELAL SETA E&LA1-256 more than 256 bytes 
Enoo 
00 ELAL>I 
xc GCELAIT,153,0¢15} Code generated for less 
ENDO than 256 bytes 
MEXIT 
2eA2 |. MNOTE 8, *PARAME TER 2 NOT NUYERIC® 


MEND 
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Inline Expansion Code: 
BLANK PRIBF,890 
Lt I15S,-AEPRIBF) These two instructions were generated from the last DO because 
xc 0(80,1512,0t151 positional parameter 2 is less than 256. 


The prototype statement establishes the call mnemonics as BLANK and indicates there 
can be two positional parameters in the call that are referenced in the body as &#1 and 
&#2. The LCLA declares &LA1 as an arithmetic set symbol. Set symbols must be declared 
following the heading and preceding any other model statements. 


The rest of the body of this MACRO is sectioned by four DO statements. The first DO is an 
error exit. If either or both expressions on each side of the OR (++) operator are true, than 
no code is generated and the MNOTE message is printed. That is, the numeric attribute of 
the parameter list (N’'&SYSLIST) is anything other than 1 or 2, then the blank MACRO will 
not work. 


The second DO is processed only if there is one parameter in the parameter list 
(N’'&SYSLIST=1). And if the area indicated by positional parameter 1 is greater than 256, 
the AIF statement will shunt the generation of the XC instruction (the blanking operation) 
and print the MNOTE message. If the numeric attribute of the parameter list is 2, then the 
second DO loop is not processed and the AIF after this DO is processed. This AIF tests 
positional parameter 2 (&#2) for a self-defining term; if it isn’t, no code is generated and the 
MNOTE is printed. 


The &LA1 set symbol is set to the value of positional parameter 2, which is the number of 
bytes to be cleared. Register 15 is loaded with the address of area (&#1). The next DO loop 
is processed once for every multiple of 256 bytes indicated in positional parameter 2 (DO 
&#2/256). If positional parameter 2 is less than 256, the next DO is processed and the last 
one is not. 


There are three sets of codes that can be generated from the BLANK example MACRO. One 
set is generated if positional parameter 2 is omitted; another if positional parameter 2 is 
more than 256; and another if positional parameter 2 is less than 256. 
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Appendix A. Sample Program 


The following list illustrates the steps taken to create, code, and execute a simple 
assembler program. The sample problem is designed to calculate the effect of a $5.00 a 
week bonus on an employee's yearly, weekly, and hourly pay. 

w Flowchart 


The flowchart provides a graphic representation of the logic steps used to solve the 


problem. 
STMT 
cue HOUSEKEEPING STORE WEEKLY 
Pe SETUP PAY 
5 thru 6 MULTIPLY BONUS DIVIDE WEEKLY 


BY 52 11 and 12 PAY BY 40 HOURS 


ADD TOTAL 
7 BONUS TO 
YEARLY PAY 


STORE HOURLY 
PAY 


MOVE TOTAL 
STORE TOTAL 
8 RECORD TO OUTPUT 
YEARLY PAY AREA 
DIVIDE THE 
9 TOTAL YEARLY 


PAY BY 52 WEEKS 
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23 


24 
25 


27 
28 


29 


Source Code 
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Source code is created to implement the logic flow set forth in the flowchart. In the 
following list, comments have been included to explain what each source statement 


does. 


SYMBOL 


PROGRAM 1 
BEGIN 


WORKAREA 


BONUS 
HOURS 
WEEKS 
YEARRATE 


OUTPUT 
EMPLOYEE 


NAME 


WORKNO 
YEARPAY 
WEEKPAY 
HOURPAY 
R6 


OPERATION 
CODE 


TITLE 


START 
BALR 
USING 
ZAP 
MP 
AP 
MVC 
DP 
MVC 
ZAP 
DP 
MVC 
MVC 
EOJ 
DS 


Dc 
DC 
bc 
DC 


DC 
DS 


DC 


DC 
DC 
DC 
DC 
EQU 


END 


STATEMENT OPERANDS 


‘FIRST SAMPLE PROGRAM’ 


ie) 

R6,0 

*R6 

WORKAREA, BONUS 
WORKAREA,WEEKS 
WORKAREA, YEARRATE 
YEARPAY,WORKAREA+ 2 
WORKAREA,WEEKS 
WEEKPAY,WORKAREA+1 
WORKAREA,WEEKPAY 
WORKAREA,HOURS 
HOURPAY,WORKAREA+2 
OUTPUT(23),EMPLOYEE 


CL6 


PL2‘500° 
PL2‘40° 
PL2‘52° 
PL4‘1300000' 


23C’ ' 
OCL23 


CL9O’REBEW R D’ 
C‘'N4543’ 

PL4'0’ 

PL3'0' 

PL2'0’ 

6 


BEGIN 


Job Control Procedure to Assemble 


COMMENTS. 


Provides the assembler listing with a 
heading. 

Provides a starting point for the program. 
Assigns a base address to the register. 
Assigns a base register to the program. 
Enter bonus rate into work area. 
Multiply bonus rate by 52 weeks. 

Add yearly rate to total bonus. 

Move calculated total to yearly pay area. 
Divide total pay by 52 weeks. 

Move results to weekly pay area. 

Move weekly pay into work area. 

Divide by 40 hours week. 

Move results to hourly pay area. 
Completed record moved to output area. 
End of job. 

Reserve 6 bytes of storage, contents 
unknown. 

Place value 5.00 in two bytes of storage. 
Place value 40 in two bytes of storage. 
Place vatue 52 in two bytes of storage. 
Place value 13000.00 in four bytes of 
storage. 

Produces 23 bytes of blanks only. 
Symbol “EMPLOYEE” represents next 23 
bytes. 

Produces nine 
“REBEWRD"”. 
Produces five bytes containing “N4543”. 
Produces four bytes of zeros. 

Produces two bytes of zeros. 

Produces two bytes of zeros. 

This instruction equates register 6 with 
R6. 

THIS {S THE END OF THE PROGRAM. 


bytes containing 


The following job control statements assemble the source code into an object code 


module. 


Job Control Statements 


// JOB ASSEMBLE 


// ASM 
1S 


F Assembler 
‘ source 


: code 
/% 
/& 
// FIN 


Comments 


Assigns a unique name to the program. 
Assembles the source code. 
Signifies the start of the source statements. 


Signifies the end of the source statements. 
Signifies the end of the job. 
Terminates card reader operation. 

















UP-8061 Rev. 3 SPERRY UNIVAC OS/3 A-3 
ASSEMBLER 





=  OQutput Generated by Assembly 


The program is now assembled and an assembly listing is generated. The assembly 
listing contains warning messages if any errors are detected in the source code. 


UNIVAC SYSTEM OS/3 ASSEMBLER VER800922 
DATE- 81/12/30 TIME- 23.09 


ASSEMBLER CONTROL STATEMENTS ENCOUNTERED AND PROCESSED &S FOLLOWS- 


4s 


EXTEQNAL SYMBOL DICTIONARY PAGE 1 
SYMBOL. TYPE. ESID. ADDRESS. LENGTH. 
PROGRAM] CSECT O01 acoodju GAII7E 
FIRST SAMPLE PROGRAM PAGE 2 
LOC. OBJECT CODE ADORI AJORZ LINE SOURCE STATEMENT 0$/3 ASM 81/12/30 
oac000 2 PROGRAMI STAST CG 
ooc000 0560 3 BESIN DAL F6,? 
000002 4 vSING #6 
OG0002 F851 605E 6044 DA940 uI046 5 Zar wORKAREA, BONUS 
000008 FC51 603£ 6048 GOB4C OINKA 6 MP wORKAPTA,WEEKS 
QOOOOE FASS GOSE 6044 JOCKD Os0KC 7 Ao wCRKAPEA,YEARRATE 
000014 D205 6073 6N¥O 30075 o0042 8 wVC YE APP AY, wCRKAIEA G2 
GOOOLA FUSI1 6035E 6048 20040 UID4K4 9 9° eORKAPEA WEEKS 
Q00020 0202 6077 603F 90079 0904} 1° MVC al EKP RY wWORKARE AS] 
OOC026 F8S2 603E 6077 BO040 U3079 11 ZAP wORKAREASWEEKPAY 
OO002C FD51 603E 6046 CoO4O 02048 12 uP aCRKAPEA HOURS 
Q00032 0201 607A 6040 O007C CIC42 1? MvC HOUOP AY »pwORKARE ASD 
000038 0216 604E 6965 50C50 09067 14 wVC GUTPUT(Z23),EMFLOVEE 
15 EON 
0000 3E A 166 cs cH Fovoo0so 
OQOOO3E OAlA A 176 SVC 26 €0yo00070 
oo004) 18 WwOPKAREA OS CLs 
000046 500C 19 36NUS tc PL2°s7ct 
000048 O40Cc 22 HOURS ue FL2"4C?* 
oo004A OS2c 21 dEEKS ec PL2°S2° 
oooo4¢e 1s9u009C 22 YEARRATE oC LS") 30ec00° 
GQO00SO 4O4¥0404040404049 23 JUTPUT L e3sc*"* 
000067 24 EMPLOYEE OS OCuet3 
Q00067 O9CSC2CSEB40D949 eS NAME ue CLI"RESEW KR OP 
000070 OSFYFSF4FS 26 dORKNO SE. C°NGS 43" 
000075 oooUuoooC 27 VEARPAY iC Puatce 
oo0079 ooou0C 23 WEEKPAY 5C PL3*S? 
oo0007C Ov0C 29 HOURPAY LC FL2°3" 
000006 33 PE £ou 6 
0000590 31 END SESIN 
CROSS-REFERENCE PAGE 1 
SYMBOL LENSTH VALUE JEFN S¥M60L LENGTH VALUE CEFN 


BEGIN Quco2 oUuoooe 90003 0031 

BONUS Quoo2 Quoos6 90019 oocs 

EMPLOYEE OU023 000067 JON24 aos 

HOURPAY 00902 oN007C c0029 0013 

HOURS guco2 000048 9020 ool2 

WNALE Q0009 000067 30025 

OUTPUT Quod1 OvuoOsoO 90025 oci4 

PROGRAM] QU0O1 Ou0000 coco2 

R6 90001 000006 00036 o003 9004 

WEEKPAY 0u003 OuG979 00028 ooro S011 

WEEKS 00002 000044 00221 case 3059 

WORKAREA 00006 Ov004O O0cl1s 00395 oOco6 7GO7 Scns Coos 
og10 O08 ‘cOIr2 90013 

WORKNO Qu0as Gudo70 O0026 

YEaRPAY 90004 9009075 50027 oucs 

VEARRATE OoO00% OVvOoOosC 30022 0097 


PIASNGSTICS PAGE 1 
LINE ERROR CODE MESSAGE 


NO STATEMENTS FLAGGED IN THIS ASSEMBLY “S1/12/3C0 23.09- 
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Y 


# Job Control! Procedure to Assemble, Link-edit, and Execute 





After the errors in the source code are corrected, the following job contro! statements 
are added to assemble the code, create a load module, and execute the program. 


Job Contro! Statements Comments 
// JOB ASSEMBLE Assigns a unique name to the program. 
// ASMLG Assembles, link-edits, and executes the program. 
/$ Signifies the start of the source statements. 
Assembler 
° source 
. code 
/* Signifies the end of the source statements. 
/& Signifies the end of the job. 
// FIN Terminates card reader operation. 
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Appendix B. Character Conversion 
Codes 


Table B—1. ASCH (American Standard Code for Information Interchange) Character Codes 





























NOTES: @ 


Some graphic card code and hexadecimal assignments may differ depending on the device, language, application, 
and installation policy. 





@ The following optional graphics can be substituted ® Graphics available by use of the 0768—02 
in the character set: Printer which prints a 94-character set (DEL is 
not a graphic) 


“T for A 
& @ Ninety-four printable character set. 
| for |! 


@ Sixty-three printable character set. 
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Table B—2. EBCDIC (Extended Binary Coded Decimal Interchange Code} Character Codes 





pe [Mn 





NOTES: 


Rae aE ae EE 
ES ea a 


? Fe 












Some graphic card code and hexadecimal assignments may differ depending on the device, language, 
application, and installation policy. 


@ 


DS, SOS, FS are the control characters for the 
EDIT instruction and have been assigned for 
ASCII mode processing so as not to conflict 
with the corresponding character positions 
previously assigned in the EBCDIC chart. As 
these characters are not outside the range as 
defined in American National Standard 
Institute X3.4 — 1968, they must not appear 
in external storage media, such as American 
National Standard [Institute standard tapes. 
This presents no difficulty due to the nature 
of the EDIT instruction. 


The following optional graphics can be substituted 
in the character set: 


A for | 


lfor ! 


For 63-character printers, the following substitution 
is made: 


\ for! 


© 


The lowercase alphabet and indicated graphics are 
introduced by use of the 0768—02 printer, which 
prints a 94-character set. 


The following substitutions are made for the 
UTS 400 handler: 


SPROT for SO 
EPROT for Sl 
SB for FS 
EB for GS 
SOE for RS 
FCC for US 
Mw for BEL 
J for ! 

! for ] 


DC4 for the UTS 400 handler. 
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Table B—3. Punched Card, ASCII, and EBCDIC Codes (Part 1 of 5) 


a Printed cs = {|__ascu | score 
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Table B—3. Punched Card, ASCII, and EBCDIC Codes (Part 2 of 5) 
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Table B—3. Punched Card, ASCII, and EBCDIC Codes (Part 3 of 5) 


Printed Card 


7 7 7 37 55 F7 247 
8 8 8 38 56 F8 248 
9 9 9 39 57 F9 249 


Character 


Symbols 
Exclamation point 
Quotation mark, dieresis 
Number sign, pound sign 


Dollar sign 


Percent sign 


Ampersand 
Apostrophe, acute accent 
Opening parenthesis 
Closing parenthesis 
Asterisk 

Plus sign 

Comma, cedilla 

Minus sign, hyphen 
Period, decimal point 
Slash, virgule, solidus 
Colon 

Semicolon 

Less than 

Equal sign 

Greater than 

Question mark 
Commercial at symbol 
Opening bracket 
Closing bracket 
Reverse slash 


Circumflex 
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Table B—3. Punched Card, ASCII, and EBCDIC Codes (Part 4 of 5} 


Printed 
Symbol 


Character 
Underline 
Grave accent 60 
Opening brace 7 


B 
Closing brace 7D 
Vertical line _ 7c 

E 


Overline, tilde 1 7 


Card | ___eacoic__— 


Nonprintable Characters 


ACK (Acknowledge) 0—9-8-6 
BEL (Bell) 0-9-8-7 
BS (Backspace) 11—9—-6 


CAN (Cancel) 11-9-8 


CR (Carriage return) 12—9-8—5 


DC1 (Device control 1) 11-9-1 

DC2 (Device control 2) 11~9-—2 

DC3 (Device control 3) 11-9-3 

DC4 (Device control 4) 9-8-4 

DEL (Delete) 12—9—7 

DLE (Data link escape) 12-—11-9—-8-1 
DS (Digit select) 11—0—9-—8-1 
EM (End of medium) 11-9-8-1 
ENO (Enquiry) 0-—9-—8-—5 
EOT (End of transmission) 9-7 

ESC (Escape) 

ETB (End of transmission block) 

ETX (End of text) 

FF (Form feed) 


FS (File separator) 
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Table B—3. Punched Card, ASCII, and EBCDIC Codes (Part 5 of 5) 


Card ASCH EBCDIC 


FS (Field separator) 82 
GS (Group separator) 1D 
HT (Horizontal tabulation) 09 


LF (Line feed) 0A 


NAK (Negative acknowledge) 15 


NUL (Null) 12—0-—9—8-1 00 
RS (Record separator) 11-9—8-—6 1E 
Si (Shift in) 12—9—8-—7 OF 
SO (Shift out) 12—9-8-6 OE 
SOH (Start of heading) 12-9-1 01 
SOS (Significance start) 0-9-1 81 
SP (Space) 20 
STX (Start of text) 02 
SUB (Substitute) 1A 
SYN (Synchronous idle) 16 
US (Unit separator) 1F 


VT (Vertical tabulation) 0B 
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Appendix C. Math Tables 


C.1. HEXADECIMAL-DECIMAL INTEGER CONVERSION 


The following table provides for conversion of hexadecimal and decimal numbers in the 


range: 


Hexadecimal 


000 to FFF 


Decimal 


0000 to 4095 


In the table, the decimal value appears at the intersection of the row representing the most 
significant hexadecimal digits (162 and 16') and the column representing the least 
significant hexadecimal digit (16°). 


Example: 


hexadecimal C21 = decimal 3105 


HEX 


CO 
C1 
C2 
C3 


os 


3072 3073 
3088 3089 
3104 3105 
3120 3121 


2 


3074 
3090 
3106 
3122 


For numbers outside the range of the table, add the following values to the table figures: 


Hexadecimal 


1000 
2000 
3000 
4000 
5000 
6000 
7000 
8000 
9000 
AOO0O 
BOOO 


Decimal 





4,096 

8,192 
12,288 
16,384 
20,480 
24,576 
28,672 
32,768 
36,864 
40,960 
45,056 





Hexadecimal Decimal 
Cooo 49,152 
DOOO 53,248 
EOOO 57,344 
FOOO 61,440 

10000 65,536 

20000 131,072 

30000 196,608 

40000 262,144 

50000 327,680 

60000 393,216 

70000 458,752 
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Example: 


BC21 16 48,1 61 10 


Hexadecimal Decimal 
C21 3,105 
+BO00 +45,056 


+BC21 48,161 
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HEXADECIMAL-DECIMAL INTEGER CONVERSION (Part 1 of 4) 


0325 
0341 
0357 
0373 
0389 
0405 
0421 
0437 
0453 
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HEXADECIMAL-DECIMAL INTEGER CONVERSION (Part 2 of 4) 
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& HEXADECIMAL-DECIMAL INTEGER CONVERSION (Part 3 of 4) 
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HEXADECIMAL-DECIMAL INTEGER CONVERSION (Part 4 of 4) 
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& C.2. HEXADECIMAL FRACTIONS (APPROXIMATE VALUES) 


a ee ee ae 


.0000 
.0002 
.0004 
.0007 
.0009 
.0012 
.0014 
.0017 
.0019 
.0021 
.0024 
.0026 
.0029 
.0031 
.0034 
.0036 


me) 
J 

2 
3 
4 
5 
6 
wi 
8 
9 
A 
.B 
Cc 
.D 
.E 
- 





To convert a 4-digit (2-byte) hexadecimal fraction to a decimal fraction, add the values 
shown in the above table for each of the hexadecimal digits to be converted as illustrated 
below. The hexadecimal fraction .B5A1 equals the approximate decimal fraction .70948791 
from the above table. 


@ .B from the table equals .6875 
.O5 from the table equals .01953125 
.OOA from the table equals .002441406250 
.0001 from the table equals .000015258789 


.B5A1 ~—s equals the sum .709487915039 
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5 
25 
625 
B12 5 
906 25 
953 125 
1 976 562 5 
2 488 281 25 
4 244 140 625 
8 122 070 312 5 
16 061 035 156 25 
32 030 517 578 125 
65 015 258 789 062 5 
131 007 629 394 §31 25 
262 003 814 697 265 625 
524 001 907 ws 632 812 5 
1 048 000 953 674 316 406 25 
2 097 000 476 837 158 203 125 
4 194 000 238 418 579 101 562 5 
8 388 000 119 209 289 550 781 25 
16 777 000 069 604 644 775 390 625 
33 554 000 029 802 322 387 695 312 5 
67 108 000 014 901 161 193 847 656 25 
134 217 000 007 450 580 596 923 828 125 
268 435 000 003 725 290 298 461 914 062 5 
536 870 000 001 862 645 149 230 957 031 25 
1 073 741 000 000 931 322 574 615 478 515 625 
147 483 000 000 465 661 287 307 739 257 812 5 


4 294 967 000 000 232 830 643 653 869 628 906 25 


8 689 934 000 000 116 415 321 826 934 814 453 125 
17 179 869 000 000 058 207 660 913 467 407 226 562 5 
34 359 738 000 000 029 103 830 456 733 703 613 281 25 
68 719 476 000 ooo 014 551 915 228 366 851 806 640 625 
137 438 953 000 000 007 275 957 614 183 425 903 320 312 5 
274 877 906 000 000 003 637 978 807 091 712 951 660 156 25 
549 755 813 000 000 001 818 989 403 545 856 475 830 078 125 


039 511 627 000 000 000 909 494 701 772 928 237 915 039 062 5 
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@ C.4. POWERS OF 16 





1 0 

16 1 

256 2 

4 096 3 

65 536 4 

1 048 576 5 

16 777216 6 

268 435 456 7 

4 294 967 296 8 

68 719 476 736 9 

1 099 511 627 776 10 

17 592 186 044 «4416 11 

281 474 976 710 «656 12 

4 503 599 627 370 6496 13 
72 057 594 037 927 936 14 
1 152 921 504 606 846 976 15 


These powers of 16 are especially useful in determining the value of floating-point 
numbers. 
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Appendix D. Check-Off Table Terms 





General 
OBJECT 
OPCODE FORMAT | INST. 
TYPE LGTH. 
Condition Codes 


LJ iF RESULT = 0,SET TOO 


































Cie RESULT <0, SETTO1 
CIF RESULT > 0, SET TO 2 
CIF OVERFLOW, SET TO 3 
(J UNCHANGED 








Possible Program Exceptions 


[] ADDRESSING 

(J DATA (INVALID SIGN/DIGIT) 
LJ DECIMAL DIVIDE 

CO DECIMAL OVERFLOW 

(J Execute 

CJ EXPONENT OVERFLOW 
CZ] EXPONENT UNDERFLOW 
CO FIXED-POINT DIVIDE 

CJ FIXED-POINT OVERFLOW 
(] FLOATING-POINT DIVIDE 
(J OPERATION 


(] PROTECTION 

(] SIGNIFICANCE 

CL) SPECIFICATION: 

NOT A FLOATING-POINT REGISTER 
OP 1 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON HALF-WORD BOUNDARY 
OP 2 NOT ON FULL-WORD BOUNDARY 


OP 2 NOT ON DOUBLE-WORD 
BOUNDARY 


OP 1 NOT EVEN NUMBERED REGISTER 
OP 1 NOT ODD NUMBERED REGISTER 
NONE 





























O00 OOOOO 


The check-off table is a fast reference source for its associated instruction. The table points 
where to look for possible errors when writing your programs and helps you debug your 
program when it does not run correctly. A program interrupt occurs when the hardware 
detects an improper specification, use of instructions or data. Interrupt requests of this type 
cause the instruction currently being executed to be suppressed or terminated. When a 
table is used with an instruction, the checked (®) condition codes and program exceptions 
are the only ones that apply to that instruction. The program exceptions are explained in the 
following list, as well as the instruction to which it applies. 


= Addressing 


A storage location outside the range of the installed storage is referenced by a 


program-specified address. 


a Data 


— An invalid sign or digit code is detected in decimal operands. 


— Fields in decimal arithmetic overlap incorrectly. 


— The first operand of the multiply decimal instruction does not have a sufficient 


number of high-order zero digits. 
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a Decimal Divide 





The quotient of a divide decimal instruction exceeds the capacity of the quotient part of 
the first operand field. 


a Decimal Overflow 


The result of an add decimal, subtract decimal, or zero and add instruction exceeds the 
capacity of the first operand location. 


= Execute 
The subject instruction of an execute instruction is an execute instruction. 
= Exponent Overflow 


The final characteristic resulting from a floating-point arithmetic operation exceeds 
127. 


= Exponent Underflow 


The final characteristic resulting from a floating-point arithmetic operation is less than 
zero. 


a Fixed-Point Divide 





The quotient of a fixed-point divide operation exceeds the capacity of the first operand 
(including division by zero) by the result of a convert to binary instruction exceeds 31 
bits. 
2 Fixed-Point Overflow 
A fixed-point add or subtract operation exceeds the capacity of the first operand field. 
= Floating-Point Divide 
The divisor fraction in a floating-point divide operation is equal to zero. 


a Operation 


An illegal operation has been attempted or an operation using a noninstalled processor 
feature has been attempted. 


a Protection 


A storage protection violation occurs on a program-generated address when the 
protection feature is installed. 


= Significance & 


The final fraction resulting from a floating-point addition or subtraction is equal to zero. 
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a #§ Specification 
— The unit of information referenced is not on an appropriate boundary. 
— An invalid modifier field is specified in the STR instruction. 


— The R, field of an instruction which uses an even/odd pair of registers (64-bit 
operand) does not specify an even register. 


— A floating-point register other than 0, 2, 4, or 6 is specified. 
— A multiplicand or divisor in decimal arithmetic exceeds 15 digits and sign. 


— The first operand field is shorter than, or equal in length to, the second operand in 
decimal multiply and decimal divide instructions. 
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Appendix E. Instruction Listings 


Included in this appendix are alphabetic listings of the mnemonic codes (Table E—1) and 
instruction names (Table E—2) and a numeric list of the machine codes (Table E—3). In 
Tables E—2 and E—3, unless otherwise indicated, mnemonic instructions are available in 
native mode only. 


Table E—1. Mnemonic List of Instructions (Part 1 of 4) 


Source Code Format 


Instruction Name 


Add 

Add Normalized, Long 
Add Normalized, Long 
Add Normalized, Short 
Add Normalized, Short 
Add Half Word 

Add tmmediate 

Add Logical 

Add Logical 

Add Decimal 

Add 

Add Unnormalized, Short 
Add Unnormalized, Short 
Add Unnormalized, Long 
Add Unnormalized, Long 
Branch and Link 

Branch and Link 

Branch and Store 

Branch and Store 

Branch on Condition 
Branch on Condition 
Branch on Count 

Branch on Count 

Branch on Index High 
Branch on index Low or Equal 
Compare Algebraic 
Compare, Long 
Compare, Long 
Compare, Short 
Compare, Short 
Compare Half Word 
Compare Logical 
Compare Logical 


Compare Logical Immediate 


Machine 
Code 


4 
4 
2 
4 
2 
4 
4 
4 
2 
6 
2 
4 
2 
4 
2 
4 
2 
4 
2 
4 
2 
4 
2 
4 
4 
4 
4 
2 
4 
2 
4 
4 
6 
Se. 


r45(x,,b,) 
r4d,(x,,b,) 
eats 

ie do{x,,b,) 
lar) 
rdo(xp! 
d, (b, hig 
rda(x,, 
fat 


d,(1,,b,).d 


Cyl 
ry dy(x,, 
rato 
r4do(x,,b,) 
ryt 

"4 id, (x,,b,) 
rls 
compatibility 


b,) 
b,) 


alla.b5) 


bp) 


mode only 


id, (x,,b,) 
2 

r,do(x,.b,) 
ro 

r4fgd_(b,) 
ryefgdo(b,) 
r,d,(x,,b,) 
rd (x b,) 


i,f, 


17 2°°2' 
22’ 


Ma" 
ry d(x, 
rho 
rdo(x,,b,) 


r4d5(x,,b5) 
d,,(l,b,).d,(b,) 


d,(b,).i, 


b,) 


F489 (Xo) 


1489 (X5) 


ry Vo 
148 (Xo) 
"a2 
ry Sy(x5) 


84:5 
ry Sy (x5) 


rats 
8, ul, )So{lo) 


ry Vo 
r48q(X5) 
"2 

ry Sy (x5) 
ue) 

: 


1 Sy(X5) 


FS (Xo) 


r4Sp(X5) 


yo 


F418Q(X5) 


Taito 
"489 


F485 (x5) 


s, (1s, 


(x,) 











UP-8061 Rev. 3 SPERRY UNIVAC 0S/3 E—2 


ASSEMBLER 


Table E—1. 


Instruction Name 


Compare Logical 
Compare Decimal 
Compare Algebraic 
Convert to Binary 
Convert to Decimal 
Divide 

Divide, Long 

Divide, Long 

Divide, Short 

Divide, Short 
Diagnose 

Divide Decimal 
Divide 

Edit 

Edit and Mark 
Execute 

Halve, Long 

Halve, Short 

Halt and Proceed 
Insert Character 
Insert Storage Key 
Load 

Load Address 

Load Complement, Long 
Load Complement, Short 
Load Complement 
Load Control Storage 
Load, Long 

Load, Long 

Load, Short 

Load, Short 

Load Half Word 
Load Multiple 

Load Negative, Long 
Load Negative, Short 
Load Negative 

Load Positive, Long 
Load Positive, Short 
Load Positive 

Load Prograrn Status Word 
Load 

Load and Test, Long 
Load and Test, Short 
Load and Test 
Multiply 

Multiply, Long 
Multiply, Long 


Mnemonic List of Instructions (Part 2 of 4} 


Machine Byte 


Code Length 


NY &EANNNNANNNNNHN KAN AN PBA NNN PA NRANN ADA NDA NAH FE FAN AN 


Source Code Format 


ryt 
d,(1,,b,),d,(1,,b,) 
rly 

rdo(x,,b,) 
rd(x,,b5) 
4d, (x2,b,) 


rd5(x,,b,) 


Tyla 


r4do(x,,b,) 


rata 
(Privileged) 


d,(l b,).d 


1{lqsby) do (lp.b5) 


Mylo 
qd, (Ib, ).d,(b,) 
d,(1,b,).d,(b,) 


r4d5(x5,b,) 


rly 
rte 
(Privileged) 
rdo(x,,b,) 
(Privileged) 
ry da (x,,b,) 
r4d5(x,,b5) 
ryikg 

ral 

Palo 
(Privileged) 
4do(x5,b,) 
rao 

ry do(x,, 
an) 
rd, (x,,b,) 
rz.d5(b,) 
rato 

Ta"2 

rato 

ryt 

ry"2 

ry"2 
(Privileged) 


b,) 


et 


"2 
Fats 
rho 
ry Vs 
ry Ao(x5,b,) 
ry d,(x,,b,) 


Fala 


Tato 
s,(14,)Sp(lo) 


ryt 
ry8o(x5) 


Sg (Xp) 
) 


152 \Xp 
ry So(x5) 
raly 

"4 Sy (x5) 


r 


Myo 
(Privileged) 
s, (1, )aSp(lo) 
we Vo 

s, (I),s, 

8, (1),s, 

" Sy (Xo) 
Ride 

ry9 
(Privileged) 
Fy 8p (x5) 
(Privileged) 
ry Sy(x5) 
ry $y (x5) 
tails 

Mat2 

ra"2 
(Privileged) 
F4y8Q(xQ) 
Fyily 

rs 8p (x5) 
Mato 

ry Sy (x) 
rytg8Q 
Tara 

""2 

rata 

Malo 

ry To 

rts 
(Privileged) 
rte 

" Vo 

rata 

Ty" 

ry Sy(x,) 
r48q(x>) 
rata 
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Table E—1. 


Instruction Name 


Multiply, Short 

Multiply, Short 

Multiply Half Word 
Multiple Decimat 

Multiply 

Move Characters 

Move Immediate 

Move Numerics 

Move With Offset 

Move Zones 

AND Logical 

AND Logical 

AND Logical Immediate 
AND Logical 

OR Logical 

OR Logical 

OR Logica! immediate 

OR Logical 

Pack 

Subtract 

Subtract Normalized, Long 
Subtract Normalized, Long 
Subtract Normalized, Short 
Subtract Normalized, Short 
Subtract Half Word 

Start 1/0 


Subtract Logical 

Shift Left Single Algebraic 
Shift Left Double Algebraic 
Shift Left Double Logical 
Shift Left Single Logical 
Supervisor Load Multiple 


Subtract Logical 

Subtract Decimal 

Set Program Mask 

Subtract 

Shift Right Single Algebraic 
Shift Right Double Algebraic 
Shift Right Double Logical 
Shift Right Single Logical 
SOFTSCOPE Forward Scan 
Set System Key 

Set System Mask 
SOFTSCOPE Reverse Scan 
Supervisor Store Muitiple 
Store 

Store Character 

Store Long 
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Mnemonic List of Instructions {Part 3 of 4) 


Machine 
Code 





Byte 
Length 


brah 2B PN F&F FFF ANNAN Fh Fh PP HANH AEN FAP AN AAP NA AMAA DAA AAA NA AN & 





Explicit 


rdolx,, 
rato 
r4do(x,b5) 

d, (1,6, ),d,(I,,b5) 
ryira 
d,(L.b,),d5(b,) 
d,(b,).i, 

d, (Lb, ).d,(b,) 

d/l ba hdsll. 
d,(1b,).d5(b,) 
rd, (x,,b,) 
d,(I,b,),d5(b,) 
d,(b,),i, 


b,) 


b,) 


Mtg 
r,d5(x,,b,) 
d,(I,b,).d5(b,) 
d,(b,).i, 


Paks 
d,(l,.b,).d, 
r,d5(x,,b5) 


r,d5(x5,b,) 


(1,,b5) 


" Vp 
r444(x,,b5) 


ryilo 
ry d5{x,,b,) 
(Privileged) 


" (x,,b5) 
rd, (b,) 
r,d,(b,) 

tr db.) 
r,d,(b,) 
(Priviteged)} 


"2 

d, (l, b, ).d 
1 

"yo 

ry d(b,) 
ry 3,(b,) 
ry ,(b,) 
rd(b,) 
(Privileged) 
(Privileged) 


(Privileged) 


al!gbQ) 


r 


(Privileged) 
(Privileged) 
ry o{x5,b5) 
r, d5(x,,b,) 


r,do(x,,b,) 








Source Code Format 


4 Sp(X5) 


bats 
4 Sq(X5) 
8, (I, Sy (15) 


s,(l, 851g) 
s, (ls, 

ry 85(x5) 

s, (1,8, 
Syriy 

ryt 

" Sq (Xo) 
s,(I),s, 
Syri5 

rls 

s,(l, ),8,(1,) 
85(x,) 
Fy8Q(Xp) 
rts 

I 4S(X5) 
Els 

ry So(x5) 
(Privileged) 


ry Sy (xp) 


"49 
ta) 
4°89 
ta) 
(Privileged) 
rate 
s, (4) 859) 


452 

ry Sp 

489 

r4So 
(Privileged) 
(Privileged) 
(Priviteged) 
(Privileged) 
(Privileged) 
r, S(x,y) 
ry 8Q(XQ) 


r4So(x5) 
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Table E—1. Mnemonic List of Instructions (Part 4 of 4) 





Source Code Format 
Instruction Name 


Store Short 

Store Half Word 

Store Multiple 

Service Timer Register 
Subtract Unnormalized, Short 
Subtract Unnormalized, Short 
Supervisor Call 


Subtract Unnormalized, Long 


Subtract Unnormalized, Long 
Test Under Mask , 


Translate 


Translate and Test 

Test and Set 

Unpack 

Exclusive OR 

Exclusive OR 

Exclusive OR, Immediate 
Exclusive OR 


Zero and Add Decimal 


Machine | Byte | neater | : 
70 


OANA MOA AAA HD AN FNN AN DL A 


r,d,(x,,b,) 
ro (x,,b,) 
ryfgda(b,) 
(Privileged) 


rdo(x>,b,) 


yo 
j 


r,d,(x,,b,) 


rata 

d, (b, rig 
d,(1,b,),d_(b,) 
d,(l,b, ),d,(b,) 
d,(b,) 
d,(1,.b,).d, 
r4do(x,,b,) 
d, (Ib, ).d,(b,) 
qd, (b, hig 


(1,,b,) 


rato 


d,(1,.b,).d 


{lqby)do(t,.b,) 


r4Sq(xy) 
" Sp(x5) 
Fyg8g 
(Privileged) 
48g (Xo) 
"4 "2 

1 

4 So(x,) 
rah 
S415 

8, ( 8, 
s, ( Ns, 


54 


8, (1,).s(1,) 
% $y(Xy) 

8, (Ns, 
Syriy 

rts 

s,(l, soll.) 
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Table E—2. Alphabetic Listing of Instructions (Part 1 of 6) 


Machine 


instruction Name 
Code 


Add (Native and 360/20 modes) 


Add 


Add Decimal 


Add Half Word (Native and 360/20 modes) 


Add Half Word (9200/9300 mode only) 

Add Immediate 

Add immediate (9200/9300 mode only) 

Add Logical 

Add Logical 

Add Normalized, Long 

Add Normalized, Long 

Add Normalized, Short 

Add Normalized, Short 

Add Unnormalized, Long 

Add Unnormalized, Long 

Add Unnormalized, Short 

Add Unnormalized, Short 

AND NR 
AND N 
AND NI* 
AND (Native and 9200/9300 modes) NC* 
Branch and Link BALR 
Branch and Link (Native and 9200/9300 modes) BAL* 
Branch and Store (360/20 mode only) BAS* 
Branch and Store (360/20 mode only) BASR* 


Branch on Condition (Native and 360/20 modes) BCR* 


Branch on Condition Bc* 
Branch on Count BCTR 
Branch on Count BCT 
Branch on Index High BXH** 


Branch on Index Low or Equal BXLE** 








4 
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Table E—2. Alphabetic Listing of Instructions (Part 2 of 6) 





Machine 


Instruction Name 
Code 


Compare 

Compare 

Compare Decimal 
Compare Half Word 
Compare Logical 
Compare Logical 
Compare Logical 
Compare Logical 
Compare, Long 
Compare, Long 
Compare, Short 
Compare, Short 
Convert to Binary 
Convert to Decimal 
Diagnose — Privileged 
Divide 

Divide 

Divide Decimal 


Divide, Long 


Divide, Long 


Divide, Short 
Divide, Short 
Edit 

Edit and Mark 
Exclusive OR 
Exclusive OR 
Exclusive OR 
Exclusive OR 


Execute 


D 


(C)DP 


DDR** 


DD** 


DER** 


DE** 


ED* 


EDMK** 


XR 


Xx 


XI 


xc 


EX 




















UP-8061 Rev. 3 SPERRY UNIVAC OS/3 
ASSEMBLER 


m 
| 
~ 





Table E—2, Alphabetic Listing of Instructions (Part 3 of 6) 


Machine 


Instruction Name 
Code 


Halt and Proceed — Privileged 
Halve, Long 

Halve, Short 

Insert Character 

Insert Storage Key — Privileged 
Load 

Load 

Load Address 


Load and Test LTR 


Load and Test, Long LTDR** 


Load and Test, Short LTER** 
Load Complement LCR** 
Load Complement, Long LCDR** 
Load Complement, Short LCER** 
Load Controi Storage — Privileged LCS 
Load Half Word LH* 
Load, Long 

Load, Long 

Load Multiple LM 

Load Negative LNR** 
Load Negative, Long LNDR** 
Load Negative, Short LNER** 
Load Positive LPR** 
Load Positive, Long LPDR** 
Load Positive, Short LPER** 
Load PSW — Privileged LPSW 
Load, Short LER** 


Load, Short LeE** 
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Table E—2. Alphabetic Listing of Instructions (Part 4 of 6) 


Instruction Name 


Move 

Move 

Move Numerics 
Move With Offset 
Move Zones (Native and 360/20 modes) 
Multiply 

Multiply 

Multiply Decimal 

Multiply Half Word 

Multiply, Long 

Multiply, Long 

Multiply, Short 

Multiply, Short 

OR 

OR 

OR 

OR (Native and 9200/9300 modes) 
Pack 

Service Timer Register — Privileged 

Set Program Mask 


Set Storage Key — Privileged 


Set System Mask — Privileged 


Shift Left Double 

Shift Left Double Logical 
Shift Left Single 

Shift Left Single Logical 
Shift Right Double 

Shift Right Double Logicai 
Shift Right Single 


Shift Right Single Logical 


Machine 
Code 


OR 


O 


ol* 


oc* 


PACK* 


STR 


SPM 


SSK** 


SSM 


SLDA** 


SLDL** 


SLA** 


SLL 


SRDA** 


SRDL** 


SRA** 


SRL 
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Table E—2. Alphabetic Listing of Instructions (Part 5 of 6) 


Instruction Name 


SOFTSCOPE Forward Scan - Privileged 
SOFTSCOPE Reverse Scan - Privileged 
Start 1/O — Privileged 

Store 

Store Character 

Store Half Word 

Store, Long 

Store Multiple 


Store, Short 


Subtract (Native and 360/20 modes) 


Subtract 

Subtract Decimal 

Subtract Half Word (Native and 360/20 modes) 
Subtract Half Word (9200/9300 mode only) 
Subtract Logical 

Subtract Logical 

Subtract Normalized, Long 

Subtract Normalized, Long 

Subtract Normalized, Short 

Subtract Normalized, Short 

Subtract Unnormalized, Long 

Subtract Unnormalized, Long 

Subtract Unnormalized, Short 

Subtract Unnormalized, Short 

Supervisor Call 

Supervisor Load Multiple — Privileged 


Supervisor Store Multiple — Privileged 


Machine 
Code 
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' Table E—2. Alphabetic Listing of Instructions (Part 6 of 6) 





Machine 


Instruction Name 
Code 


Test and Set 


Test Under Mask 
Translate 
Translate and Test 
Unpack 


Zero and Add 





NOTE: 


Unless otherwise indicated, mnemonic instructions are available in native mode only. 
*Available in native mode and 9200/9300 and 360/20 compatibility modes except as noted. 


**Added as a feature. 


tExecutes machine code in 9200/9300 compatibility mode only. 


Table E—3. List of Instructions by Machine Code (Part 1 of 6) 





Machine Code Instruction Name 


Service Timer Register — Privileged 

Set Program Mask 

Branch and Link 

Branch on Count 

Branch on Condition (Native and 360/20 modes) 


Set Storage Key — Privileged 


Insert Storage Key — Privileged 


Supervisor Call 


ee Branch and Store (360/20 mode only) 


Load Positive 
Load Negative 


Load and Test 
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Table E—3. List of Instructions by Machine Code (Part 2 of 6) 


OR 


XR 


LR 


CR 


AR* 


SR* 


MR** 


DR** 


ALR** 


SLR** 


LPDR** 


LNDR** 


LTDR** 


LCDR** 


HDR** 


LDR** 


CDR** 


ADR** 


SDR** 


MDR** 


DDR** 


AWR** 


SWR** 


LPER** 


LNER** 


LTER** 





Instruction Name 


Load Complement 

AND 

Compare Logical 

OR 

Exclusive OR 

Load 

Compare 

Add (Native and 360/20 modes) 
Subtract (Native and 360/20 modes) 
Multioly 

Divide 


Add Logical 


Subtract Logical 


Load Positive, Long 

Load Negative, Long 

Load And Test, Long 

Load Complement, Long 
Halve, Long 

Load, Long 

Compare, Long 

Add Normalized, Long 
Subtract Normalized, Long 
Multiply, Long 

Divide, Long 

Add Unnormalized, Long 
Subtract Unnormalized, Long 
Load Positive, Short 

Load Negative, Short 


Load And Test, Short 
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Table E—3. List of Instructions by Machine Code {Part 3 of 6) 





Machine Code Instruction Name 


LCER** Load Complement, Short 
HER** Halve, Short 
LER** Load, Short 


CER** Compare, Short 


AER** Add Normalized, Short 


SER** Subtract Normalized, Short 
MER** Multiply, Short 

DER** Divide, Short 

AUR** Add Unnormalized, Short 
SUR** Subtract Unnormalized, Short 
STH* Store Half Word 

LA Load Address 


Store Character 





Insert Character 

Execute 

Branch and Link (Native and 9200/9300 modes) 
Branch on Count 

Branch on Condition 

Load Half Word 

Compare Half Word 

Add Half Word (Native and 360/20 modes) 
Subtract Half Word (Native and 360/20 modes) 
Multiply Half Word 

Branch and Store (360/20 mode only) 

Convert to Decimal 

Convert to Binary 

Store 


AND 





Compare Logical 
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Table E—-3. List of Instructions by Machine Code (Part 4 of 6) 


Machine Code Instruction Name 


OR 

Exclusive OR 
Load 

Compare 

Add 

Subtract 
Multiply 

Divide 

Add Logical 
Subtract Logical 
Store, Long 
Load, Long 
Compare, Long 


Add Normalized, Long 


Subtract Normalized, Long 


Multiply, Long 

Divide, Long 

Add Unnormalized, Long 
Subtract Unnormalized, Long 
Store, Short 

Load, Short 

Compare, Short 

Add Normalized, Short 
Subtract Normalized, Short 
Multiply, Short 

Divide, Short 

Add Unnormalized, Short 
Subtract Unnormalized, Short 
Set System Mask — Privileged 


Load PSW — Privileged 
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Table E—3. List of Instructions by Machine Code (Part 5 of 6) 


DIAG 


BXH** 


BXLE** 


SRL 


SLL 


SRA** 


SLA** 


SRDL** 


SLDL** 


SRDA** 


SLDA** 


STM 


TM* 


MVI* 


Ts** 


NI* 





Instruction Name 


Diagnose — Privileged 
Branch on Index High 
Branch on Index Low or Equal 
Shift Right Single Logical 
Shift Left Single Logical 
Shift Right Single 

Shift Left Single 

Shift Right Double Logical 
Shift Left Double Logical 
Shift Right Double 

Shift Left Double 

Store Multiple 

Test Under Mask 

Move Immediate 

Test and Set 

AND 

Compare Logical 

OR 

Exclusive OR 

Load Multiple 

Halt and Proceed — Privileged 
Add Immediate 


Start 1/O — Privileged 


SOFTSCOPE Forward Scan - Privileged 


SOFTSCOPE Reverse Scan - Privileged 
Add immediate (9200/9300 mode only) 
Add Half Word (9200/9300 mode only) 
Subtract Half Word (9200/9300 mode only) 
Supervisor Store Multiple — Privileged 


Load Control Storage — Privileged 
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Table E—3. List of Instructions by Machine Code (Part 6 of 6) 


Machine Code Instruction Name 


Supervisor Load Multiple — Privileged 
Move Numerics 
Move 
Move Zones (Native and 360/20 modes) 
AND (Native and 9200/9300 modes) 
Compare Logical 
OR (Native and 9200/9300 modes) 

XC Exclusive OR 

TR* Translate 

TRT Translate and Test 

ED* Edit 

EDMK** Edit and Mark 

MVO* Move With Offset 

PACK* Pack 

UNPK* Unpack 

ZAP* Zero and Add 

CP* Compare Decimal 

AP* Add Decimal 

sP* Subtract Decimal 

MP* Multiply Decimal 


DP* Divide Decimal 





NOTE: 


Unless otherwise indicated, mnemonic instructions are available in native mode only. 


*Available in native mode and 9200/9300 and 360/20 compatibility modes except as noted. 
**Added as a feature. 


+Executes machine code in 9200/9300 compatibility mode only. 
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Appendix F. Use of PARAM Statement 


This appendix describes the use of the PARAM statement and the option-specifying 
operands supported by the SPERRY UNIVAC Operating System/3 (OS/3) Assembler. These 
options permit you to identify library files, to access source or copy modules and macro 
definitions from these libraries, to select assembler listings, and to control object module 
output. Also included in this appendix is the source module correction routine. 


F.1. PARAM STATEMENT 
The PARAM statement specifies the assembler processing options in effect at assembly 
time and alters the standard default options. If you don't specify assembler options in the 


control stream of your job, the assembler functions as follows: 


= The assembler searches only the system source library file (SY$SRC) for any source 
module or copy code referenced. 


= ~§=6It also searches only the system macro library file (SYSMAC) for any macro references. 

= ~= It stores the object module produced in the job run library file (SYSRUN). 

= It prints the soruce code, object code, cross-references, and diagnostic listings. 

s The value of &SYSPARM is equal to a null string. 

= Columns 1 and 2 of the coding form must contain slashes, followed by at least one 
blank column, and then PARAM followed by at least one blank column (see following 
page). Multiple options are supported for each option separated by commas. The end of 


selected options is indicated by a blank column following the last option. All options 
selected are printed preceding the assembly listing. 
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Format: 










filename filename2 
// \APARAMA COPY= (N) | (N) 


E N=modulename [ H games | 


om (ah ae 


[.ust= { ene [,s4] i] 


filename 


sYsPARMe 4, Sting \] 


_ 





















COPY Keyword Parameter: 


Enables up to two files to be identified as source code module libraries or specifies that 
no files are to be searched for source code modules. If this option is omitted, $Y$SRC is 
assumed and is the only file searched for source code module references. Only source 
modules can be copied; the source code must be in the standard format and may not 
contain any COPY, ICTL, MACRO, PROC, or MEND directives. 


COPY=filename' 

Specifies that the file identified as filename1 is searched first for source code 
modules referenced and, if not found there, then $Y$SRC is searched: filename is 
any name you specify or the system source library. If filename1 = filename2, then 
copy = filename1 will generate the same files to be searched as copy = 
/filename2, except that in the first case the order in which the files are to be 
searched will be filename1 and then $Y$SRC, whereas in the second case, the 
order will be $YSSRC and then filename2. 


COPY=filename'1 /filename2 
Specifies that the file identified as filename1 is searched first. Then, the file 
identified as filename2 is searched for source code modules referenced. When 
two filenames are specified for this parameter, the $Y$SRC file is not searched. 
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@ COPY=filename1 /(N) 
Specifies only the file identified as filename1 is searched for source code modules 
referenced. As stated previously, if filenamel = filename2, then copy = 


filename1/(N) is the same as copy = (N)/filename2, with only one file to be 
searched in either case. 


COPY=(N) 
Specifies no files, not even S$YSSRC, are searched for source code modules 
referenced. COPY=(N)/{N) is the same as COPY=(N). 


IN Keyword Parameter: 


Identifies the name of the source module that is to be assembled and the file in which 
it resides. If this option is omitted, the source code must be in the control stream. 


IN=modulename 
Specifies the name of the source module and directs the assembler to search the 
SYSSRC file for the module; modulename is the name of the source module and is 
up to eight characters. 


IN=modulename/ filename 
Specifies the name of the source module and the file in which it resides; filename 
& is any name you supply or the system source library. 


LIN Keyword Parameter: 


Enables up to two files to be identified as macro source files or no files to be searched 
for macro references. If this option is omitted, $YSMAC is assumed and is the only file 
searched. 


LIN=filenamet 
Identifies the file that is searched for macro references and, if not found there, 
then $Y$MAC is searched; filename is any name or the name of the system macro 
library. 


LIN=filename1 /filename2 
Identifies the two files that are searched for macro references. The file identified 
as filename1 is searched first, followed by the file identified as filename2. The 
SYSMAC file is not searched. 


LIN=filename1 /(N) 
Specifies only the file identified as filename1 is searched for macro references. 


LIN=(N) 
Specifies no files, not even $SYSMAC, are searched for macro references. 
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LST Keyword Parameter: 


Indicates the type of listing desired. If this option is omitted, source, object, cross- 
reference, and diagnostic listings are printed. 


LST=s 


A single specification requiring no parentheses. 


LST=([s,]...[,S4]) 
Any s in the series is one of the following: 


NC 


Specifies that the cross-reference listing is suppressed. 


ND 


Specifies that the diagnostic listing is suppressed. 


NR 


Specifies that the cross reference listing is to contain only those symbols 
that have at least one reference each. 


Specifies that all output listings are suppressed. 


DBG 


Specifies a proc or macro debug mode feature within the OS/3 assembler. 
When the feature is selected, the output listing shows the following: 


Results of the expansion of any proc or macro called within the user 
program, including any conditional assembly directives processed as the 
result of the expansion itself. Source coding (constants, directives, and 
instructions) is listed twice and shows any appropriate substitutions. Any 
statements causing error diagnostics show the exit line in error. 


A proc or macro which produces error diagnostics at the time it is 
encoded is listed following the END directive; e.g., system errors. A proc 
or macro is encoded once, but may be called multiple times. 


If an error is detected at both expansion and encoding time, it appears 
two or more times. Errors detected only at encoding time appear once 
following the END directive. 


All lines flagged (regardless of their order of appearance) are shown in 
the diagnostic summary list. Lines flagged at encoding time may or may 
not be flagged at expansion time. 


When this feature is not selected, any errors detected during proc or macro 
expansion may not show the exact line in error, but rather the vicinity of the 
item which is flagged. 
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OUT Keyword Parameter: 


Enables you to specify the file that is to be used to store the object module output by 
the assembler. If this option is omitted, the object module is generated and stored in 
SYSRUN, the system-run library. 


OUT=filename 
Identifies the file that is used as the output file by the assembler; filename is any 
name or the job run library. 


OUT=(N) 
Specifies that no output file is used by the assembler and, thus, no object module 
is generated. 


RO Keyword Parameter: 


Permits you to optionally flag all absolute/base displacement fields of instructions 
that yield values less than 4096. Each statement is flagged with an 
‘ADDRESSABILITY’ error flag. For example, if you wanted to code MVI TAG,X’40’ but 
coded MVC TAG,X‘40' by mistake, the latter instruction would be flagged, since the 
displacement field is less than 4096. 


SYSPARM Keyword Parameter: 


Specifies the equivalent of a global SETC symbol, with the value specified in this 
option. If this option is omitted, the value of &SYSPARM is a null string. 


Operational Consideration: 


The value established by SYSPARM is available within the assembly, both outside of 
and within macro definitions. This parameter is referenced as &SYSPARM within 
assembly statements. Any error in this specification directs the assembler to ignore the 
specification, and an appropriate error message is printed on the output printer. 


SYSPARM=‘string’ 
Specifies a string of one to eight characters enclosed in apostrophes. An 
apostrophe within the string is represented by two apostrophes but only counts as 
one in determining the length of the string. 


F.2. SOURCE CORRECTIONS 


The OS/3 assembler supports a source module correction routine. This routine is the same 
as the one used in the librarian. The correction deck is interchangeable between the 
assembler and the librarian except that the librarian also uses the added COR control 
statement. The corrections made to the source module are temporary. The corrections are 
specified by the presence of both the source module input (//APARAMAIN=modulename 
or the IN=(vol-ser-no,label) for the jproc call) and the correction records in the job control 
stream. These records must be with the data delimiters (/$ and /*). If there are no records 
between the data delimiters, no source correction is performed. 
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There are three control statements associated with the correction routine: sequence (SEQ), 
recycle (REC), and skip (SKI). To make the source module corrections, the actual source 
record to be inserted is used as the correction card with the same sequence number as the 
record to be replaced. Insertions are performed by using at least one correction card (always 
the first) card with a sequence number falling between the sequence numbers of the 
records between which the insertion is to be made. Any number of unsequenced correction 
cards may then follow the first sequence card. Deletions are performed by bypassing one or 
more original source module records in the old data set, thus eliminating them from being 
written on the new data set. The SKI and REC statements are used for this function. 


F.2.1. SEQ Statement 

Function: 
Specifies the starting position and the length of the sequence field. If the sequence file 
is omitted, column 73 is assumed to be the first column of the sequence field and 


continues to the maximum of eight characters. 


Format: 







AOPERATIONA OPERAND 





{ column position ; { content \ 
7 * (00000000 


"te 


Specifications: 
column position 
Is the first column position in the source record where the sequence field begins. 
If omitted, column 73 is assumed to be the first column of the sequence field. 


content 
Is one to eight characters. The length determines the length of the sequence field. 


Operational Considerations: 
= = =Card column 1 must be blank if the sequence field does not start in card column 1. 


= The SEQ card is always the first card in the correction routine. 
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F.2.2. REC Statement 


Function: 


Causes the record pointer for the input module to be repositioned to the first record in 
the module. In conjunction with the SKI control statement, it allows the rearranging of 
major segments of the input module. When a REC control statement is processed, 
records are read from the input module up to and including the record whose sequence 
number matches the sequence number in the REC control statement field. Then, the 
second pointer for the input module is reset to the first record in the module. If the 
sequence field of the REC control statement is blank, repositioning of the record pointer 
takes place immediately. 


Format: 









A OPERATION A OPERAND SEQUENCE 





unused 






unused [last-sequence no.] 


Specification: 


last sequence no. 
Is one to eight alphanumeric characters that identify the sequence number of the 
last input record to be read from the input module. If omitted, the repositioning 
function takes place immediately. 


Operational Considerations: 


m Records are replaced one at a time by writing a source statement with a sequence 
number matching the sequence number of the record to be replaced. 


7 Records are inserted by writing source correction statements with sequence numbers 
that fall between the sequence numbers of the input records between which insertion 
is to take place. Blank sequence fields cause an insertion to take place immediately. 


F.2.3. SKI Statement 
Function: 


Allows one or more original input module records to be bypassed. Records are read 
from the input module until a sequence number is detected that matches the sequence 
number of the SKI command. The skip operation is started and continues until a 
sequence number that matches the operand field of the SK! command is detected. If 
the sequence field of the skip command is blank, the function is started immediately. 
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Format: 





AOPERATION A OPERAND 







SEQUENCE 





ignored [last-sequence no.] [starting-sequente no. ] 


Specifications: 


last-sequence-no. 


Is one to eight alphanumeric characters that identify the sequence number of the 
last input module record to be bypassed. 


starting-sequence-no. 


Is one to eight alphanumeric characters that identify the sequence number of the 
first source module record to be bypassed. 


Operational Consideration: 


= If omitted, the skip operation starts immediately with the input module record that 
follows the last record operated on. 
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Appendix G. System Variable Symbols 


System variable symbols automatically generate values or character strings at assembly 
time. There are seven system variable symbols: &SYSECT, &SYSLIST, &SYSNDX, 
&SYSDATE, &SYSTIME, &SYSJDATE, and &SYSPARM. The following paragraphs contain 
the functions of each of the seven system variable symbols. 


G.1. &SYSECT 


&SYSECT is a system variable symbol used to represent the name of the control section 
containing a macro instruction. 


&SYSECT is assigned a value for each inner and outer macro instruction processed by the 
assembler. This value is the name of the control section containing the macro instruction. If 
&SYSECT is referenced in a macro definition, its substituted value is the name of the last 
CSECT, DSECT, or START directive that occurred prior to the macro instruction. If a named 
CSECT, DSECT, or START directive did not appear prior to the macro instruction, &SYSECT 
is assigned a null character value during the processing of the macro definition called by the 
macro call instruction. 


Any CSECT or DSECT directives processed within a macro definition affect the value of 
&SYSECT for any subsequent inner macro instructions in the definition and for any outer 
and inner macro instructions that occur outside the current nest of macro definitions. 
However, the value of &SYSECT remains constant during the processing of a given macro 
instruction, and is not affected by CSECT or DSECT directives or inner macro instructions 
occuring in that macro definition. 


G.2. &SYSLIST 


Within a macro definition in macro format, each positional parameter may be referenced by 
a name; however, each positional parameter need not be named in the macro prototype 
statement and may be referenced in terms of its position within the macro instruction 
operand field by wiring the system variable symbol &SYSLIST followed by an expression in 
parentheses. The value of the expression identifies the position of the parameter in the 
operand field. The expression may be a SETA symbol or a self-defining term. Therefore, if a 
macro definition prototype statement has the operand field: 


&A,&B,&C 





UP-8061 Rev. 3 SPERRY UNIVAC OS/3 G—2 
ASSEMBLER 


the first positional parameter is referenced either as &A or &SYSLIST(1), the second is 
referenced either as &B or &SYSLIST(2), and the third positional parameter is either &C or 
&SYSLIST(3), and so on. This capability, which is used to index through the positional 
parameters, treats each parameter in the same way. 


A null character string is generated in place of &SYSLIST(m) if m is zero or greater than the 
number of positional parameters supplied in the macro instruction. 


The system variable &SYSLIST may not be used in a mixed-mode (positional and keyword 
parameters included) macro definition. 


G.3. &SYSNDX 


The assembler maintains a counter that is incremented by 1 each time the assembler 
encountered a macro instruction. The value of this counter within the first macro is 1. The 
current value of this counter is supplied as the 4-digit character value of the system variable 
symbol &SYSNDX each time a macro instruction is encountered. A macro definition that 
defines labels within the code it generates, and that may be called more than once ina 
single assembly, generally creates duplicate definitions of the same label. To avoid this 
problem, the system variable symbol &SYSNDX may be used as a suffix on the labels 
defined by the macro definition, so that each time the macro definition is called, it will 
define a different set of labels. 


G.4. &SYSDATE 

&SYSDATE is a system variable symbol, which you can reference in your program text or 
within a macro definition, to generate the date your program is assembled. The date is 
produced in your assembly listed as a character string representing the month, day, and 
year (mm/dd/yy) the program was assembled. If you 

1. assemble your program, 

2. store it in a library, and 


3. retrieve the assembled program for execution at a later date, 


any &SYSDATE reference in your program references the original assembly date, not the 
current date when your program is executed. 


You specify &SYSDATE as either an operand in a source code statement, which defines a 
constant (DC), or an operand field literal. 


LABEL AOPERATIONA OPERAND 
1 10 16 





° 
° 


ASMDATE DC C'&SYSDATE' 
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e When this line of source code is assembled, the object code contains the current date. 


You can also use the &SYSDATE system variable symbol as a literal. 





LABEL AOPERATIONA OPERAND 
1 10 16 
MVC BUF ,=C' &SYSDATE' 


When this line of source code is executed, the assembly date is moved into a main storage 
area calied BUF. 


G.5. &SYSTIME 
&SYSTIME is a system variable symbol, which you can reference either in your program text 
or within a macro definition, to generate the time of day your program is assembled. The 


time is produced in your assembly listing as a character string representing the hour, 
minute, and second (hh.mm.ss) the assembly was run. If you 


& 1. assemble your program, 
2. store it in a library, and 
3. retrieve the assembled program for execution at another time, 


any &SYSTIME reference in your program references the original assembly time, not the 
current time of execution. 


You specify &SYSTIME as either an operand in a source code statement, which defines a 
constant (DC), or an operand field literal. 


e 


ASMTIME OC C'&SYSTIME' 


When this line of source code is assembled, the object code contains the current time. 


You can also use the &SYSTIME system variable symbol as a literal. 


& MVC BUF ,=C' SYSTIME! 


When this line of source code is executed, the assembly time is moved into a main storage 
area called BUF. 
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G.6. &SYSJDATE 

&SYSJDATE is a system variable symbol, which you can reference either in your program 
text or within a macro definition, to generate the Julian date when your program is 
assembled. The date is produced in your assembly listing as a character string representing 
the month, day, year, and Julian value — day of the year {mmddyjjj) the assembly was run. If 
you 

1. assemble your program, 

2. store it in a library, and 


3. retrieve the assembled program for execution at another time, 


any &SYSJDATE reference in your program references the Julian date of the original 
assembly. 


You specify &SYSJDATE as either an operand in a source code statement, which defines a 
constant (DC), or an operand field literal. 





LABEL AOPERATIONA OPERAND 
| 10 16 
JULDATE DC C'&SYSJDATE' 


When this line of source code is assembled, the object code contains the Julian date. 
You can also use the &SYSJDATE system variable symbol as a literal. 


MVC BUF ,=C'&§SYSJDATE' 


When this line of source code is executed, the Julian date is moved into a main storage area 
called BUF. 


G.7. &SYSPARM 


&SYSPARM is a system variable symbol, which you can reference either in your program 
text or within a macro definition, to generate an 8-byte null character string at assembly 
time. The string is initially null but can be varied by using the PARAM statement as follows: 


LABEL A OPERATION A OPERAND 


/[/APARAMA SYSPARM=‘string’ 
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By using the PARAM statement, you can specify a string of up to eight characters, enclosed 
in apostrophes. Once you've altered the value of &SYSPARM, any reference to &SYSPARM 
produces the character string you specified in the PARAM statement, not a null character 
string. 


To reference the &SYSPARM system variable symbol, you specify &SYSPARM as either an 
operand in a source code statement, which defines a constant (DC), or an operand field 
literal. 


LABEL AOPERATIONA OPERAND 

1 10 16 

ee eae ane eee ene 
NULSTRNG DC C'éSYSPARM' 


When this line of source code is assembled, the object code contains an 8-byte null 
character string. 


You can also use the &SYSPARM system variable symbol as a literal. 


HVC BUF ,=C'&SYSPARM' 


If you don’t precede this source code statement with a PARAM statement when this line of 
source code is executed, an 8-byte null character string is moved into a main storage area 
called BUF. 
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operational considerations 10.5 10-13 ANOP statement ; 
example 27.2.4 27-18 
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examples 27.2.3 27-17 function 27.2.4 27-17 
format 27.2.3 27-16 
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AP. instruction 
examples 
formats 
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operational considerations 


Apostrophe, character representation 


Application instructions 
explicit length 
formats 
implicit length 
types 


AR instruction 
example 
format 
function 
operational considerations 


Arithmetic operators 
absolute terms 
description 


ASCII 


ASM Jproc call statement 
examples 
format 
function 


ASML Jproc call statement 
format 
function 


ASMLG Jproc call statement 
format 
function 


Assemble and link-edit 
ASML Jproc call statement 
function 


Assemble, link-edit, and execute 
ASMLG jproc call statement 


Assembler application instruction 
notations 
assembled example 
explicit format 
implicit format 
machine code 
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446 


7.1 
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7.1 
71 
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29.3.2.1 
29.3.2 


29.3.3.1 


4. 
41 
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4.1.1 


Page 


29-12 
29-12 


29-14 
29-14 


29-12 
29-11 


Term 


Assembler coding form 
additional coding rules 
column 72 
comments field 
continuation field 
description 
example 


label field 
operand field 
operation field 
sample 
sequence field 


Assembler control directives 
basic functions 
condition no operation (CNOP) 
generate literal poo! (LTORG) 
program card (END) 
program start (START) 
specify location counter (ORG) 


Assembling 
assemble, link-edit, and execute 
coding 
job control procedures 


Assemble listing 
definition 
example 
organization 


sample 


Assign base register (USING) directive 


Attribute references, conditional assembly 


applications 
count 
example 
format 
function 
integer 
length 
number 
scale 


Attributes of symbols 
length 


relocatability 
type 
value 
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29.1 


4.1.2 
29.6 


Page 


1 ' l ' 
me 
oo 


_ 
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i) 


17-1 
17-2 
17-5 
17-4 
17-8 
17-6 


29-3 
1-1 
29-1 


4-6 
29-17 


See organization 


of listing. 
Fig. 1-8 


1-14 


See USING directive. 
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27.5 

275 

27.5.4 
27.5.2 
27.5.6 
27.5.3 
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4.25 
4.2.3 
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4.2.3 
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27-29 
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27-23 
27-28 
27-27 
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27-28 
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4-13 
4-12 
27-25 
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example 11.6 11-16 assign base register (USING) 18.2 18-3 
formats 11.6 11-15 unassign base register (DROP) 18.1 18-2 
function 11.6 11-15 
operational consideration 11.6 11-15 Basic Assembly Language (BAL) See BAL. 
AUR instruction BC instruction 
example 11.7 11-17 formats 8.5 8-10 
formats 11.7 11-17 function 8.5 8-10 
function 11.7 11-17 operational consideration 8.5 8-12 
operational consideration 11.7 11-17 
BCR instruction 
AW instruction formats 8.5 8-10 
example 11.8 11-20 function 8.5 8-10 
formats 11.8 11-19 operational consideration 8.5 8-12 
function 11.8 11-19 
operational consideration 11.8 11-19 BCT instruction 
example 8.6 8-15 
AWR instruction formats 8.6 8-14 
example 11.9 11-21 function 8.6 8-14 
formats 11.9 11-21 
function 11.9 11-21 BCTR instruction 
operational consideration 11.9 11-21 format 8.6 8-14 
function 8.6 8-14 
Binary constants (B) 
function §.2.3 5-9 
padding 5.2.3 5-9 
B truncating 5.2.3 5-9 
B, type constant 5.2.3 5-9 Binary representation 2.2 2-2 
BAL BLANK macro example 30.3 30-4 
general description 11 1-1] 
sample program Appendix A Braces within brackets 4.1.2 4-4 
BAL instruction Branch and link (BAL) instruction See BAL 
example 8.4 8-7 instruction. 
formats 8.4 8-6 
function 8.4 8-6 Branch and link (BALR) instruction See BALR 
instruction. 
BALR instruction 
example 8.4 8-7 Branch and store (BAS and BASR) 
format 8.4 8-6 instructions See BAS and 
function 8.4 8-6 BASR instructions. 
BAS and BASR instructions Branch on condition (BC) instruction See BC 
format 8.3 8-5 instruction. 
function 8.3 8-5 
Branch on condition (BCR) instruction See BCR 
Base and displacement constants (S) instruction. 
examples 5.2.10 5-13 
function 5.2.10 5-13 Branch on count (BCT) instruction See BCT 


instruction. @ 





UP-8061 Rev. 3 SPERRY UNIVAC OS/3 Index 5 
ASSEMBLER 
Term Reference Page Term Reference Page 
Branch on count (BCTR) instruction See BCTR 
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instruction See BxH formats 10.6 10-15 
instruction. function 10.6 10-15 
: operational considerations 10.6 10-16 
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(BXLE) instruction See BKLE C, type constant 5.2.1 5-8 
instruction. 
Braihine CCW instruction 
examples 21.6 
conditional branch (AIF) 27.23 27-16 ee aie 
define branch destination (ANOP) 27.2.4 27-17 faction 16 
function 27.2 27-14 eee 
tional derat 21.6 
macro definition exit (MEXIT) 27.25 27-18 ee a ee 
sequence symbols 27.2.1 27-14 GD Gistraction 
unconditional branch (AGO) 27.2.2 27-15 examples 11.10 11-24 
ae: : formats 11.10 11-23 
Branching instructions fineHan 11.10 11-23 
BAL 8.4 8-6 : : F 5 
| 11. 11-24 
BALR BA 8-6 operational considerations 1.10 
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ace 85 - examples 1111 11-26 
C ; 8- } formats peel 11-25 
ea . a : function 1 11-25 
FX 87 1 6 operational considerations 11.11 11-25 
extended mnemonic codes os as se CE instrickion 
. ane PL a examples 11.12 11-28 
function 8.1 8-1 formats 11.12 11-27 
: . function 11.12 11-27 
BKH instruction operational considerations 11.12 11-27 
examples 14.1.1 14-3 
formats 14.11 14-2 CER instruction 
munch ul ae examples 11.13 11-30 
; : formats 11.13 11-29 
BXLE instruction function 11.13 11-29 
formats 14.1.2 14-5 operational considerations 11.13 11-29 
function 14.1.2 14- 
CH instruction 
Pe na examples 10.8 10-20 
definition 2.1 2-1 formats 10.8 10-19 
word structure Fig. 4-2 4-7 faction 10.8 10-19 
operational considerations 10.8 10-20 


Channel command word (CCW) 


Character constants (C) 
function 
padding 
truncation 


See CCW instruction. 
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Term 


Character conversion codes 
American Standard Code for Information 
Interchange (ASCII) 


Extended Binary Coded Decimal 
Interchange Code (EBCDIC) 


punched card 


Character expression 


Character representation 
alphabetic 
asterisk 
description 
numeric 
special characters 
special letters 


Character strings value 


Check-off table 
explanation 
format 
terms 


CL instruction 
examples 
formats 
function 
operational considerations 


CLC instruction 
examples 
formats 
function 
operational considerations 


CLI instruction 
examples 
formats 
function 
operational considerations 


CLR instruction 
example 
formats 
function 
operational considerations 


Reference 


4.4.6 


Appendix D 
Appendix D 
Appendix D 


12.6 
12.6 
12.6 
12.6 


12.7 
12.7 
12.7 
12.7 


12.8 
12.8 
12.8 
12.8 


12.9 
12.9 
12.9 
12.9 


Page 


12-15 
12-14 
12-14 
12-15 


12-18 
12-17 
12-17 
12-18 


12-21 
12-20 
12-20 
12-21 


12-26 
12-25 
12-25 
12-26 


Term 


CNOP directive 
examples 
format 
function 
Code an assembler program 


Code generation, repetitive 


CODEDIT section, listing content 


COM directive 
examples 
format 
function 


Comments field, coding form 
examples 
forms 
Comments statement 
Common storage definition (COM) 
directive 
Compare (C) instruction 


Compare (CR) instruction 


Compare, long format (CD) 
instruction 


Compare, long format (CDR) 
instruction 


Compare, short format (CE) 
instruction 


Compare, short format (CER) 
instruction 


Reference 


17.1 
17.1 
17.1 
Ll 


See repetitive 





code generation 


statements. 


28.3 
Table 28-1 


19.1 
19.1 
19.1 


11.4 
1.1.4 


27.3.3 


See COM 


directive. 


See C 
instruction. 


See CR 


instruction. 


See CD 
instruction. 


See CDR 
instruction. 


See CE 
instruction. 


See CER 
instruction. 


28-2 
28-2 


19-2 


27-20 
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Compare decimal (CP) Convert to binary (CVB) 
instruction See CP instruction See CVB 
instruction. instruction. 
Compare half word (CH) Convert to decimal (CVD) 
instruction See CH instruction See CVD 
instruction. instruction. 
Compare logical (CL) COPY directive 
instruction See CL example 21.5 21-7 
instruction. format 21.5 21-7 
function 21.5 21-7 
Compare logical (CLC) 
instruction See CLC Correction deck F.2 F-5 
instruction. 
Count attributes 27.5.5 27-29 
Compare logical (CLI) 
instruction See CLI CP. instruction 
instruction. examples 9.4 9-11 
formats 9.4 - 
Compare logical (CLR) function 9.4 9-10 
instruction See CLR operational considerations 9.4 9-11 
instruction. 
CR instruction 
Complex relocatable expressions examples 10.7 10-18 
definition 4.43 4-17 format 10.7 10-17 
examples 4.4.3 -17 function 10.7 10-17 
restrictions 4.43 4-17 operational considerations 10.7 10-17 
Condition no operation (CNOP) Cross-reference section, listing 
directive See CNOP content 28.5 28-4 
directive. Table 28-3 28-4 
Conditional assembly CSECT directive 
attribute references 275 27-23 examples 19.2 19-5 
branching 27.2 27-14 format 19.2 - 
error messages and comments 27.3 27-18 function 19.2 19-5 
repetitive code generation 27.4 27-21 
set symbols 27.1 27-2 CVB instruction 
summary Table 27-1 27-1 examples 10.9 10-22 
formats 10.9 10-21 
Conditional assembly control counter function 10.9 10-21 
(ACTR) statement See ACTR operational considerations 10.9 10-21 
statement. 
CVD instruction 
Conditional branch (AIF) example 10.10 10-25 
statement See AIF formats 10.10 10-24 
statement. function 10.10 10-24 
operational considerations 10.10 10-25 
Continuation column, coding form 1.1.4 1-8 
Control section identification 
(CSECT) directive See CSECT 


directive. 
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Term Reference Page Term Reference Page 
D Default option, example 412 4-5 
D instruction Define branch destination (ANOP) 
example 10.11 10-28 statement See ANOP 
formats 10.11 10-27 statement. 
function 10.11 10-27 ; 
operational considerations 10.11 10-28 Define end of range (ENDO) 
statement See ENDO 
D, type constant §.2.12 5-15 statement. 
Data area program exceptions Appendix D Define start of range (D0) 
statement See DO 
DC statement statement. 
alignment 5.1.1 5-4 — 
constant specification 5.1.1 5-4 Definition-type symbol, DC 
definition 5.11 5-4 statement 5.1.1 5-4 
example 5.1.1 5-4 
Definition types 
examples 11.14 11-32 B character 5.2.3 5-9 
formats 11.14 11-31 C character 5.2.1 5-8 
function 11.14 11-31 D character 5.2.12 5-15 
operational considerations 11.14 11-31 E character 9.2.12 9-15 
F character 5.2.7 5-12 
DOR instruction function 5.1 5-1] 
examples 11.15 11-34 H character 5.2.6 5-11 
formats 11.15 11-33 P character 5.2.4 5-10 
function 11.15 11-33 S character 5.2.10 5-13 
operational considerations 11.15 11-33 V character 9.2.11 5-14 
X character 5.2.2 5-9 
DE instruction Y character 5.2.8 5-12 
examples 11.16 11-36 Z character 5.2.5 5-10 
formats 11.16 11-35 
function 11.16 11-35 Delete operation code (OPSYM) 
operational considerations 11.16 11-35 directive See OPSYM 
directive. 
Decimal divide, program exception Appendix D 
DER instruction 
Decimal instructions example 11.17 11-38 
add decimal (AP) 93 9-8 formats 11.17 11-37 
compare decimal (CP) 9.4 9-10 function 11.17 11-37 
divide decimal (DP) 95 9-12 operational considerations 11.17 11-37 
move with offset (MVO) 9.9 9-33 
multiply decimal (MP) 9.11 9-38 Diagnose (DIAG) instruction 13.4.1 13-9 
pack decimal (PACK) 9.12 9-40 
packed decimal manipulation 91 9-1 Diagnostic section, listing content 28.6 28-5 
subtract decimal (SP) 9.13 9-44 Table 28-4 28-5 
unpack decimal (UNPK) 9.14 9-47 cae 
zero and add (ZAP) 9.15 9-50 Digit field 2.4.3.1 2-6 


Decimal overflow, program exception Appendix D Digit select byte, ED instruction 9.6.1 9-16 
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Term Reference Page Term Reference Page 
Directives DROP directive 
base register assignment 18.1 18-1 examples 18.1 18-2 
basic functions Table 15-1 15-1 format 18.1 18-2 
control 17.1 -1 function 18.1 18-2 
input and output control 21.1 -1 
listing control 20.1 0-1 DS statement 
program linking and sectioning 19.1 -] alignment 5.1.7 5-8 
constant specification 5.1.6 5-7 
Divide (D) instruction See D definition 5.1.1 5-4 
instruction. definition-type symbol 5.1.4 5-6 
duplication factor 5.1.3 5-5 
Divide (DR) instruction See DR examples 5.1.2 5-5 
instruction. format 5.1.1 5-1 
length factor (L) 5.1.5 5-6 
Divide, long format (DD) 
instruction See DD DSECT directive 
instruction. examples 19.3 19-8 
format 19.3 19-7 
Divide, long format (DDR) function 19.3 19-7 
instruction See DOR 
instruction. Dummy control section identification 
(DSECT) directive See DSECT 
Divide, short format (DE) directive. 
instruction See DE 
instruction. Duplication factor 
function 5.1.3 5-5 
Divide, short format (DER) length attribute 4.2.3 4-11 
instruction See DER zero examples Table 5-2 5-6 
instruction. 
Divide decimal (DP) 
instruction See DP 
instruction. 
DO statement 
format 27.4.1 27-21 E, type constant 5.2.12 5-15 
function 27.4.1 27-21 
EBCDIC Table B-2  _B-2 
Double word 2.5 2-9 
ED instruction 
DP instruction examples 9.6.1 -17 
example 9.5 9-13 formats 9.6 -15 
formats 9.5 9-12 function 9.6 -15 
function 95 9- operation summary Table 9-1 9-25 
operational considerations 9.5 9-12 operational considerations 9.6 9-15 
program exception Appendix D 
Edit (ED) instruction See ED 
DR instruction instruction. 
example 14.2.1 14-8 
formats 14.2.1 14-7 Edit and mask (EDMK) 
function 14.2.1 14-7 instruction See EDMK 
operational considerations 14.2.1 14-7 instruction. 
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EDMK instruction Exclusive or (Xf) instruction See XI 
example 14.3.3 14-40 instruction. 
formats 14.3.3 14-39 
function 14.3.3 14-39 Exclusive or (XR) instruction See XR 
operational considerations 14.3.3 14-39 instruction. 
EJECT directive Execute (EX) instruction See EX 
format 20.1 20-2 instruction. 
function 20.1 20-2 
Execution 1.4 1-17 
Ellipsis 4.1.2 4-6 
Explicit formats 7.2 7-5 
END directive 
examples 17.2 17-4 Explicit source code 
format 17.2 17-4 examples 7.2 7-5 
function 17.2 17-4 format 7.2 7-5 
End-of-data job control statement Exponent overflow, program exception Appendix D 
(/*) 29.5.1 29-15 
Exponent underflow 
ENDO statement AD instruction 11.2 11-3 
examples 27.4.2 27-22 ADR instruction 11.3 11-6 
format 27.4.2 27-22 AE instruction 11.4 11-9 
function 27.4.2 27-22 AER instruction 115 11-12 
program exception Appendix D 
ENTRY directive eS 
example 19.4 19-9 Expressions 
format 19.4 19-9 absolute term 44 4-15 
function 19.4 19-9 character 44.4 4-18 
complex relocatable 4.4.3 4-17 
EQU directive declaration 6.2 6-3 
examples 16.1 16-2 definition 44 4-15 
format 16.1 16-1 evaluation 44 4-15 
function 16.1 16-1 final result 44 4-15 
intermediate results 44 4-15 
Equate (EQU) directive See EQU length attribute 4.45 4-18 
directive. relocatable term 4.4.2 4-17 
Error messages and comments External address constants (V) 
MNOTE message statements 27.3.1 27-19 function 5.2.11 
PNOTE message statements 27.3.2 27-20 padding 5.2.11 - 
truncating 5.2.11 5-15 
EX instruction 
example 8.7 8-18 Externally defined symbol declaration 
formats 8.7 8-16 (EXTRN) directive See EXTRN 
function 8.7 8-16 directive. 
operational considerations 8.7 -18 
program exception Appendix D Externally referenced symbol declaration 
(ENTRY) directive See ENTRY 
Exclusive or (X) instruction See X directive. 
instruction. 
EXTRN directive 
Exclusive or (XC) instruction See XC examples 19.5 19-10 
instruction. format 19.5 19-10 
function 19.5 19-10 
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Term 


F, type constant 

Field separator byte, ED instruction 
Fill character, ED instruction 
Fixed-point divide, program exception 


Fixed-point instructions 
add (A) 
add (AR) 
add half word (AH) 
add immediate (Al) 
compare (C) 
compare (CR) 
compare half word (CH) 
convert to binary (CVB) 
convert to decimal (CVD) 
divide (D) 
divide (DR) - featured 
general discussion 
load (L) 
load and test (LTR) 
load complement (LCR) - featured 
load half word (LH) 
load (LR) 
load multiple (LM) 
load negative (LNR) - featured 
load positive (LPR) - featured 
multiply (M) 
multiply half word (MH) - featured 
multiply (MR) - featured 
shift left double (SLDA) - featured 
shift left single (SLA) - featured 
shift right double (SRDA) - featured 
shift right single (SRA) - featured 
store (ST) 
store half word (STH) 
store multiple (STM) 
subtract (S) 
subtract half word (SH) 
subtract (SR) 


Fixed-point numbers 
description 
formats 


Fixed-point overflow, program exception 


Floating-point addition 
AD instruction 
ADR instruction 
AE instruction. 
AER instruction 
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ASSEMBLER 
Reference Page Term Reference 
Floating-point constants (E and D) 
example 5.2.12 
5.2.7 5-12 formats 5.2.12 
Fig. 5-1 
9.6.1 9-16 function 5.2.12 
96.1 9-16 Floating point divide, program exception Appendix D 
Appendix D Floating-point instructions 
add normalized, long format (AD) 11.2 
add normalized, long format (ADR) 11.3 
10.2 10-7 add normalized, short format (AE) 11.4 
10.3 10-9 add normalized, short format (AER) 11.5 
10.4 10-11 add unnormalized, short format (AU) 11.6 
10.5 10-13 add unnormalized, short format (AUR) 117 
10.6 10-15 add unnormalized, tong format (AW) 11.8 
10.7 10-17 add unnormalized, long format (AWR) 11.9 
10.8 10-19 compare, long format (CD) 11.10 
10.9 10-21 compare, long format (CDR) 11.11 
10.10 10-24 compare, short format (CE) 11.12 
10.11 10-27 compare, short format (CER) 11.13 
14.2.1 14-7 divide, long format (DD) 11.14 
10.1 10-1 divide, long format (DDR) 11.15 
10.12 10-31 divide, short format (DE) 11.16 
10.14 10-35 divide, short format (DER) 11.17 
14.2.2 14-9 general description 11.1 
10.15 10-37 halve, long format (HDR) 11.18 
10.13 10-33 halve, short format (HER) 11.19 
10.16 10-39 load, long format (LD) 11.22 
14.23 14-11 load, long format (LDR) 11.23 
14.2.4 14-14 load, short format (LE) 11.24 
10.17 10-45 load, short format (LER) 11.25 
14.2.6 14-19 load and test, long format (LTDR) 11.30 
14.25 14-17 load and test, short format (LTER) 11.31 
14.2.7 14-22 load complement, long format (LCDR) 11.20 
14.2.8 14-25 load complement, short format (LCER) 11.21 
14.2.9 14-28 load negative, long format (LNDR) 11.26 
14.2.10 14-3] load negative, short format (LNER) 11.27 
10.18 10-49 load positive, long format (LPDR) 11.28 
10.19 10-51 load positive, short format (LPER) 11.29 
10.20 10-53 multiply, long format (MD) 11.32 
10.21 10-56 multiply, long format (MDR) 11.33 
10.23 10-61 multiply, short format (ME) 11.34 
10.22 10-58 multiply, short format (MER) 11.35 
store, long format (STD) 11.40 
store, short format (STE) 11.41 
25 2-9 Subtract normalized, long format (SD) 11.36 
Fig. 2-2 9-9 subtract normalized, long format (SDR) 11.37 
subtract normalized, short format (SE) 11.38 
Appendix A subtract normalized, short format (SER) = 11.39 
subtract unnormalized, long format (SW) 11.44 
subtract unnormalized, long format (SWR) 11.45 
11.2 11-3 subtract unnormalized, short format (SU) 11.42 
11.3 11-6 subtract unnormalized, short format (SUR) 11.43 
11.4 11-9 
115 11-12 


Page 


5-17 


5-15 


11-3 

11-6 

11-9 

11-12 
11-15 
11-17 
11-19 
11-21 
11-23 
11-25 
11-27 
11-29 
11-31 
11-33 
11-35 
11-37 
11-1 

11-39 
11-4] 
11-47 
11-49 
11-51 
11-53 
11-63 
11-65 
11-43 
11-45 
11-55 
11-57 
11-59 
11-61 
11-67 
11-69 
11-71 
11-73 
11-83 
11-85 
11-75 
11-77 
11-79 
11-81 
11-91 
11-93 
11-87 
11-89 
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ASSEMBLER 
Term Reference Page Term Reference Page 
Floating-point numbers Halve, short format (HER) instruction See HER 
description 2.6 2-9 instruction. 
format 2.6 2-9 
HDR instruction 
Full word 2.1 2-1 example 11.18 11-40 
formats 11.18 11-39 
Full-word address constants (A) function 11.18 11-39 
function 5.2.9 5-13 operational considerations 11.18 11-39 
padding 5.2.9 
truncating 5.2.9 5-13 HER instruction 
example 11.19 11-42 
Full-word fixed-point constants (F) formats 11.19 11-41 
function 5.2.7 5-12 function 11.19 11-41 
padding 5.2.7 5-12 operational considerations 11.19 11-41 
truncating 5.2.7 5-12 
Hexadecimal constant (X) 
function 5.2.2 5-9 
padding 5.2.2 5-9 
G truncating 5.2.2 5-9 
General register privileged instructions 13.6 13-13 Hexadecimal-decimal integer conversion C.1 C-1 
General registers 3.2 3-3 Hexadecimal fractions (approximate values) C.2 C-7 
Generate literal pool (LTORG) Hexadecimal representation 
directive See LTORG description 2.3 2-3 
directive. notation Table 2-2 2-4 
Global set symbols HPR instruction 13.2.1 13-2 
examples 27.1.2 27-5 
format 27.1.2 27-4 
function 27.1.2 27-4 
I 
H 
ICTL directive 
H, type constant 5.2.6 5-11 examples 21.1 
format 21.1 1- 
Half word 2.1 2-1 function 21.1 21-2 
Half-word address constants (Y) Implicit format 
function 5.2.8 5-12 coding 7.3 7-6 
padding 5.2.8 5-12 examples 7.3 7-6 
truncating 5.2.8 5-12 
Implicit source code 
Half-word fixed-point constants (H) examples 7.1 7-4 
function 5.2.6 5-11 7.3 7-6 
padding 5.2.6 5-11 format 73 7-6 
truncating 5.2.6 5-11 


Include code from a library 
Halve, long format (HDR) instruction See HDR (COPY) directive See COPY 


instruction. directive. 
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Term 


Inline expansion code 
BLANK macro 
function 
generation 
variable 


Input and output control directives 
basic functions 
include code from a library (COPY) 
input format control (ICTL) 
input sequence control (ISEQ) 
produce a record (PUNCH) 
reproduce following record (REPRO) 


Input format control (ICTL directive) 


Input sequence control (ISEQ) directive 


Insert character (IC) instruction 
examples 
formats 
function 
operational considerations 


Insert storage key (ISK) instruction 


Instruction 
aligning 
application 
branching 
decimal 
definition 
featured 
fixed-point 
floating-point 
logical 
privileged 
RR 
RS 
RX 
SI 
SS 
status switching 


Instruction listings 
alphabetic 
machine code 
mnemonics 


Reference 


30.3 
22.1 
23.1 
23.1 
30.3 


Table 21-1 
21.5 
21.1 
21.2 
21.4 
21.3 


See ICTL 
directive. 


See ISEQ 
directive. 


12.14 
12.14 
12.14 
12.14 


13.2.2 


71 
7.1 
8.1 
9.1 
74 
14.1 
10.1 
11.1 
12.1 
13.1 
7.1 
71 
71 
71 
7.1 
13.1 


Table E-2 
Table E-3 
Table E-1 
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Page Term Reference 
ISK instruction 13.2.2 
30-4 
22-1 ISEQ directive 
23-1 example 21.2 
23-2 format 21.2 
30-4 function 21.2 
Integer attributes 
21-1 examples 275.4 
21- function 27.5.4 
Italics 4.1.2 
21-5 
J 
12-40 Job control cards 
12-39 end-of-data job control statement 
12-39 (/*) 29.5.1 
12-39 end-of-job contro! statement (/&) 29.5.2 
terminate-the-card-reader job 
13-3 control statement (//FIN) 29.5.3 
Job control procedures 
7-3 running an assembler program 29.1 
7-1 source deck introduction 29.2 
8-1 
9-1 JOB control statement 
7-6 format 29.2.1 
14-1 function 29.2.1 
10-1 
11-1 
12-1 
13-1 
7-3 
7-3 
71-3 
7-3 
7-3 
13-1 K 
Keyword parameters 
E-5 coding 412 
E-10 referencing in the call 25.3 
E-1 26.3 


Page 


13-3 


27-28 
21-28 


4-6 


29-15 
29-16 


29-16 


4-4 
25-4 
26-4 
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Term 


L instruction 
example 
formats 
function 
operational considerations 


LA instruction 
examples 
formats 
function 
operational considerations 


Label argument, PROC format 
Label field, coding form 


LCDR instruction 
example 
formats 
function 
operational considerations 


LCER instruction 
example 
formats 
function 
operational considerations 


LCR instruction 
example 
format 
function 
operational considerations 


LCS instruction 


LD instruction 
example 
formats 
function 
operational considerations 


LDR instruction 
example 
formats 
function 
operational considerations 


Reference 


10.12 
10.12 
10.12 
10.12 


12.15 
12.15 
12.15 
12.15 


25.6 


1.1.3 


11.20 
11.20 
11.20 
11.20 


11.21 
11.21 
11.21 
11.21 


14.2.2 
14.2.2 
14.2.2 
14.2.2 


13.2.3 


11.22 
11.22 
11.22 
11.22 


11.23 
11.23 
11.23 
11.23 
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Page 


10-32 
10-31 
10-31 
10-31 


12-42 
12-41 
12-4] 
12-41 


25-11 


1-6 


11-44 
11-43 
11-43 
11-43 


11-46 
11-45 
11-45 
11-45 


14-10 
14-9 
14-9 
14-9 


11-48 
11-47 
11-47 
11-47 


11-49 
11-49 
11-49 
11-49 


ASSEMBLER 


Term 


LE instruction 
example 
formats 
function 
operational considerations 


Least significant bit (LSB) 


Leave blank lines on listing 
(SPACE) directive 


Length attribute 
application instruction 
conditional assembly 
duplication factor 
examples 
expressions 
referencing 
terms 


Length factor 
boundary alignment 
L character 


LER instruction 
example 
formats 
function 
operational consideration 


Less than operator 


LH instruction 
example 
formats 
function 
operational considerations 


Linkage editor 
creating a load module 
functions 


Listing contents control (PRINT) 
directive 


Listing control directives 
advance listing (EJECT) 
basic functions 
introduction 
leave blank lines on listing (SPACE) 
listing content control (PRINT) 
listing title declaration (TITLE) 





Index 14 
eee 


Reference 


11.24 
11.24 
11.24 
11.24 


See LSB. 


See SPACE 
directive. 


5.1.5 
27.5.2 
4.23 
9.1.5 
444 
4.2.5 
4.2 


5.1.5 
5.1.5 


11.25 
11.25 
11.25 
11.25 


4.3 


10.15 
10.15 
10.15 
10.15 


13 
29.3.3 


See PRINT 
directive. 


20.1 
Table 20-1 
20.1 
20.3 
20.2 
20.4 


~ @ 


11-52 
11-51 
11-51 
11-51 


5-6 
27-27 


11-53 
11-53 
11-53 
11-53 





4-13 


10-38 
10-37 
10-37 
10-37 


1-16 
29-13 


20-2 
20-1 
20-1 
20-5 
20-3 


“ @ 
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Term Reference Page Term Reference Page 
Listing title declaration (TITLE) Load address (LA) instruction See LA 
directive See TITLE instruction. 
directive. 
Load and test, long format (LTDR) See LTDR 
Literals instruction instruction. 
defined 4.2 4-8 
4.2.2 4-10 Load and test (LTR) instruction See LTR 
5.3 5-18 instruction. 
examples 5.3 5-19 
restrictions 5.3 5-18 Load and test, short format (LTER) 
source code 4.2.2 4-10 instruction See LTER 
specification 4.2.2 4-10 instruction. 
LM instruction Load complement, long format (LCDR) 
examples 10.16 10-40 instruction See LCDR 
formats 10.16 10-39 instruction. 
function 10.16 10-39 
operational considerations 10.16 10-40 Load complement, short format (LCER) 
instruction See LCER 
LNDR instruction instruction. 
example 11.26 11-56 
formats 11.26 11-55 Load complement (LCR) instruction 
function 11.26 11-55 - featured See LCR 
operational considerations 11.26 11-55 instruction. 
LNER instruction Load control storage (LCS) instruction 13.2.3 13-4 
example 11.27 11-58 
formats 11.27 11-57 Load half word (LH) instruction See LH 
function 11.27 11-57 instruction. 
operational considerations 11.27 11-57 
Load module, creating 1.3 1-16 
LNR instruction 
example 14.2.3 14-12 Load multiple (LM) instruction See LM 
format 14.2.3 14-11 instruction. 
function 14.2.3 14-11 
operational considerations 14.2.3 14-11 Load negative, long format (LNDR) 
instruction See LNDR 
Load (L) instruction See L instruction. 
instruction. 
Load negative, short format (LNER) 
Load (LR) instruction See LR instruction See LNER 
instruction. instruction. 
Load, long format (LD) instruction See LD Load negative (LNR) instruction See LNR 
instruction. instruction. 
Load, long format (LDR) instruction See LDR Load positive (LPR) instruction See LPR 
instruction. instruction. 
Load, short format (LE) instruction See LE Load positive, long format (LPDR) 
instruction. instruction See LPDR 
instruction. 
Load, short format (LER) instruction See LER 
instruction. Load positive, short format (LPER) 
instruction See LPER 


instruction. 
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Term 


Load program status word (LPSW) instruction 


Local set symbol 
examples 
format 
function 


Location counter 
adding 1 
asterisk 
definition 
restrictions 
values 


Logical instructions 
add logical (AL) - featured 
add logical (ALR) - featured 
and (N) 
and (NC) 
and (NI) 
and (NR) 
compare logical (CL) 
compare logical (CLC) 
compare logical (CLI) 
compare logical (CLR) 
edit (ED) 
edit and mark (EDMK) - feature 
exclusive or (X) 
exclusive or (XC) 
exclusive or (KI) 
exclusive or (XR) 
general description 
insert character (IC) 
load address (LA) 
move character (MVC) 
move immediate (MVI) 
move numerics| (MVN) 
move zones (MVZ) 
or (0) 
or (0C) 
or (Ol) 
or (OR) 
shift left double logical (SLDL) 
- featured | 
shift left single] logical (SLL) 
shift right double logical (SRDL) 
- featured 
shift right single logical (SRL) 
store character; (STC) 
subtract logical) (SL) - featured 
subtract logical| (SLR) - featured 
test under mask (TM) 
translate (TR) | 
translate and test (TRT) 





Reference 


13.2.4 


27.1.1 
27.1.1 
27.1.1 


4.2.4 
4.24 
4.24 
4.24 
4.2 


14.3.1 
14.3.2 
12.2 
12.3 
12.4 
12.5 
12.6 
12.7 
12.8 
12.9 
9.6 
14.3.3 
12.10 
12.11 
12.12 
12.13 
12.1 
12.14 
12.15 
9.7 
12.16 
9.8 
9.10 
12.17 
12.18 
12.19 
12.20 


14.3.4 
12.21 


14.3.5 
12.22 
12.23 
14.3.6 
14.3.7 
12.24 
12.25 
12.26 
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14-34 
14-37 
12-2 

12-5 

12-8 

12-11 
12-14 
12-17 
12-20 
12-25 
9-15 

14-39 
12-27 
12-30 
12-33 
12-36 
12-1 

12-39 
12-41 
9-26 

12-43 
9-30 

9-36 

12-45 
12-48 
12-51 
12-54 


14-42 
12-57 


14-45 
12-60 
12-62 
14-48 
14-51 
12-64 
12-67 
12-70 
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Term 


Logical operators 
Low order 
Lowercase letters 


LPDR instruction 
example 
formats 
function 
operational 


LPER instruction 
example 
formats 
function 
operational 


LPR instruction 
example 
format 
function 
operational 


LPSW instruction 


LR instruction 
example 
format 
function 
operational 


LSB 


LTDR instruction 
example 
formats 
function 
operational 


LTER instruction 
example 
formats 
function 
operational 


LTORG directive 
format 
function 


LTR instruction 
example 
format 
function 
operational 





and terms, coding 


considerations 


considerations 


considerations 


considerations 


considerations 


considerations 


considerations 


Index 16 
Reference Page 
4.3.2 4-14 
4.1.2 4-8 
4.1.2 4-6 
11.28 11-60 
11.28 11-59 
11.28 11-59 
11.28 11-59 
11.29 11-62 
11.29 11-61 
11.29 11-61 
11.29 11-61 
14.3.4 14-15 
14.3.4 14-14 
14.3.4 14-14 
14.3.4 14-14 
13.2.4 13-5 
10.13 10-34 
10.13 10-33 
10.13 10-33 
10.13 10-33 
2.1 2-1 
4.1.2 4-7 
11.30 11-64 
11.30 11-63 
11.30 11-63 
11.30 11-63 
11.31 11-66 
11.31 11-65 
11.31 11-65 
11.31 11-65 
17.3 
17.3 
10.14 10-36 
10.14 10-35 
10.14 10-35 
10.14 10-35 
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Term 


M instruction 
example 
formats 
function 
operational considerations 


Machine code 
assembler format relationships 
definition 
instruction listing 
purpose 


Macro call instruction 
call-names 
format 
functions 


keyword parameter 
parameter-list 
positional parameter 


MACRO definition 
accessing in library 
accessing in source deck 
body 
call-name 
call instruction design 
examples 


general 
heading 


macro instruction and definition, 
communication 

operation 

parameter substitution 

PROC and MACRO instructions 
compared 

prototype statement 

storage 

trailer 

variable inline expansion code 

variable symbol 


Macro definition exit (MEXIT) 
statement 
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Reference 


10.17 
10.17 
10.17 
10.17 


Fig. 4-1 
4.1.1 
Table E-3 
1.2 


23.3 
23.3 
22.2 
23.3 
23.3 
23.3 
23.3 


Fig. 23-2 
Fig. 23-1 
23.1 
23.1 
24.2 
Fig. 24-4 
Section 30 
24.1 
23.1 
Fig. 24-1 


Fig. 24-3 
23.1 
23.1 


Fig. 24-2 
24.2 
23.2 
23.1 
23.1 
24.2 


See MEXIT 
statement. 
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24-8 
23-1 
23-2 


24-6 
24-2 
23-3 
23-1 
23-2 
24-2 


Term 


Macro design 
macro call instruction 
macro definition 
macro definition storage 


Macro facility 
processor 
source code 


MACRO format 

basic design 

label argument 

referencing keyword parameters 
in the call 

referencing positional parameters in 
the call 

referencing subparameters in the call 


Macro (MACRO) definition 


Macro processor 
function 
inline macro expansion 
SYSMAC 


Macro source code 
example 
function 
macro facility 
types 
SYSMAC 


Main computer storage addressing 
data field 
instruction 
symbolic 


Math tables 
hexadecimal-decimal integer 
conversion 
hexadecimal fractions (approximate 
values) 
powers of 2 
powers of 16 


MD instruction 
example 
formats 
function 
operational considerations 


Index 17 


Reference 


23.3 
23.1 
23.2 


22.1 
22.2 


26.1 
26.5 


26.3 


26.2 
26.4 


See MACRO 
definition. 


22.1 
Fig. 22-1 
22.1 


30.3 
22.2 
22.2 
22.2 
22.2 


3.1.2 
3.1.1 
3.1.1 


C.1 


C.2 
C3 
C4 


11.32 
11.32 
11.32 
11.32 








Page 


26-4 


26-2 
26-5 


11-68 
11-67 
11-67 
11-67 
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Term Reference Page Term Reference Page 
MDR instruction Move zones (MVZ) instruction See MVZ 
example 11.33 11-70 instruction. 
formats 11.33 11-69 
function 11.33 11-69 MP instruction 
operational considerations 11.33 11-69 example 9.11 9-39 
formats 9.11 9-38 
ME instruction function 9.11 9-38 
example 11.34 11-72 operational considerations 9.11 9-39 
formats 11.34 11-71 
function 11.34 11-71 MR instruction 
operational considerations 11.34 11-71 example 14.2.5 14-18 
format 14.2.5 14-17 
MER instruction function 14.2.5 14-17 
example 11.35 11-74 operational considerations 14.2.5 14-17 
formats 11.35 11-73 
function 11.35 11-73 MSB 2.1 2-1 
operational considerations 11.35 11-73 412 4-8 
Message character, ED instruction 9.6.1 9-17 Multiple options, coding 4.12 4-5 
MEXIT statement Multiply (M) instruction See M 
format 27.2.5 27-18 instruction. 
function 27.2.5 27-18 
Multiply (MR) instruction See MR 
MH instruction instruction. 
example 14.2.6 14-21 
formats 14.2.6 14-19 Multiply, long format (MD) 
function 14.2.6 14-19 instruction See MD 
operational considerations 14.2.6 14-20 instruction. 
Mnemonic Multiply, long format (MDR) 
definition ll 1-4 instruction See MDR 
instruction listing Table E-1 E-1 instruction. 
operation code 1.1.1 1-4 - 
Multiply, short format (ME) 
MNOTE message statement instruction See ME 
example 27.3.1 27-19 instruction. 
format 27.3.1 27-19 
function 27.3.1 27-19 Multiply, short format (MER) 
instruction See MER 
Most significant bit (MSB) See MSB. instruction. 
Move character (MVC) instruction See MVC Multiply decimal (MP) 
instruction. instruction See MP 
instruction. 
Move immediate (MVI) instruction See MVI 
instruction. Multiply half word (MH) See MH 
instruction. 
Move numeric (MVN) instruction See MVN 
instruction. MVC instruction 
examples 9.7 9-27 
Move with offset (MVO) formats 9.7 9-26 
instruction See MVO function 97 9-26 
instruction. operational considerations 9.7 9-26 
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Term Reference Page Term Reference Page 
MVI_ instruction NR instruction 
examples 12.16 12-44 example 12.5 12-12 
formats 12.16 12-43 formats 12.5 12-11 
function 12.16 12-43 function 12.5 12-11 
operational considerations 12.16 12-43 operational considerations 12.5 12-12 
MVN instruction Number attributes 
examples 9.8 9-31 example 27.5.6 27-30 
formats 9.8 9-30 function 27.5.6 27-30 
function 9.8 9-30 
operational considerations 9.8 9-30 Numeric data, comparison Table 2-1 2-2 
MVO instruction Numeric representation 
examples 9.9 9-34 packed format 2.4.3.2 2-7 
formats 99 9-33 unpacked format 2.4.3.1 2-6 
function 9.9 9-33 
operational considerations 9.9 9-33 
MVZ instruction 
examples 9.10 9-37 0 instruction 
formats 9.10 9-36 example 12.17 12-46 
function 9.10 9-36 formats 12.17 12-45 
operational considerations 9.10 9-36 function 12.17 12-45 
operational considerations 12.17 12-46 
Object code 
example 12 
N instruction format 1.2 - 
examples 12.2 12-3 
formats 12.2 12-2 Object module format Fig. 1-9 1-16 
function 12.2 12-2 
operational considerations 12.2 12-3 Object program 
definition 4.1.2 4-6 
NC instruction general 1.2 1-12 
example 12.3 12-6 
formats 12.3 12-5 OC instruction 
function 12.3 12-5 example 12.18 12-49 
operational considerations 12.3 12-6 formats 12.18 12-48 
function 12.18 12-48 
NI instruction operational considerations 12.18 12-49 
examples 12.4 12-9 
formats 12.4 12-8 Ol instruction 
function 12.4 12-8 examples 12.19 12-53 
operational considerations 12.4 12-9 formats 12.19 12-51 
function 12.19 12-51 
Normalization operational considerations 12.19 12-52 
AD instruction 11.2 11-3 
ADR instruction 11.3 11-6 Operand field, coding form ll 1-4 
AE instruction 11.4 11-9 
AER instruction 11.5 11-12 Operand length, ED 
instruction 9.6 9-15 
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Term Reference Page Term Reference Page 

Operation, program exception Appendix D 

Operation field, coding form 111 1-4 P type constant 524 5-10 

Operators Pack decimal (PACK) 
arithmetic 4.3.1 4-14 instruction See PACK 
description 4.3 4-13 instruction. 
logical 4.3.2 4-14 
priority Table 27-2 27-8 PACK instruction 
relational 4.3.3 4-15 examples 243.2 2-7 
summary Table 4-2 4-13 9.12 9-4] 

nee formats 9.12 9-40 

OPSYM directive function 9.12 9-40 
example 16.2 16-3 operational considerations 9.12 9-4] 
format 16.2 16-3 packed format conversion 2.4.3.2 2-7 
function 16.2 16-3 

Packed decimal constant (P) 

OPTION job control statement function 524 -10 
examples 29.2.2 29-2 padding 524 -10 
function 29.2.2 29-2 truncation 5.2.4 5-10 

Option-specifying operands F.1 F-1 PARAM statement 

a format F.1 F-2 
Optional information, coding 4.1.2 4-4 function Fl F-1 
: ; operational considerations F.1 F-5 
OR, bit comparison 43.2 4-14 
: ; PNOTE message statement & 

OR instruction format 27.3.2 27-20 
example 12.20 12-55 function 27.3.2 27-20 
formats 12.20 12-54 
function vat 12.20 12-54 Positional parameter 0 
operational considerations 12.20 12-55 description 55 25-9 

example 30.1 30-1 

Or (0) instruction See 0 

instruction. Positional parameters 
; : coding 4.1.2 4-6 
Or (OC) instruction See 0C comma 412 4-6 
instruction. referencing in the call 25.2 25-3 
; : 26.2 26-2 
Or (Ol) instruction See OI 
instruction. Powers 
aca ot of 2 C3 C-8 

ORG directive of 16 CA c-9 
examples 17.4 17- 
format 17.4 17- Preface section of listing 28.2 28-1 
function 17.4 1]7- 

Sat ws PRINT directive 

Organization of listing format 20.2 20-3 
CODEDIT 28.3 28-2 examples 20.2 20-4 
cross-reference 28.5 28-4 function 20.2 20-3 
diagnostic 28.6 28-5 
example 29.6 29-17 Privileged. instructi tat! -] 
external symbol dictionary (ESD) 28.4 28-3 SUT, poe aarc pee ne = 3 
preface 28.2 28-1 ® 

0S/3 Assembler 11 1-1 

Output, assembly listing Section 28 








UP-8061 Rev. 3 


SPERRY UNIVAC OS/3 


index 21 


A 


@ Term 


PROC definition 
call instruction design 
examples 


general 

heading 

MACRO and PROC instruction 
compared 

macro instruction and definition, 
communication 

variable symbol 


PROC format 

basic design 

label argument 

multiple PROC names and 
positional parameter 0 

referencing keyword parameters 
in the call 

referencing positional parameters 
in the call 

referencing subparameters in 
the call 


Procedure (PROC) definition 


Produce a record (PUNCH) 
directive 


Program end (END) directive 


Program exceptions 
addressing 
data 
decimal divide 
decimal overflow 
execute 
exponent overflow 
exponent underflow 
fixed-point divide 
fixed-point overflow 
floating-point divide 
operation 
protection 
significance 
specification 


Reference 


24.2 
Fig. 24-4 
30.2 
24.1 
Fig. 24-1 


Fig. 24-2 


Fig. 24-3 
24.2 


25.1 
25.6 


25.5 
25.3 
25.2 
25.4 


See PROC 
definition. 


See PUNCH 
directive. 


See END 
directive. 


Appendix 
Appendix 
Appendix 
Appendix 
Appendix 
Appendix 
Appendix 
Appendix 
Appendix 
Appendix 
Appendix 
Appendix 
Appendix 
Appendix 
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ASSEMBLER 
Page Term 
Program linking and sectioning directives 
24-2 common storage definition (COM) 
24-11 control section identification 
30-2 (CSECT) 
24-1 dummy control section identification 
24-2 (DSECT) 
externally defined symbol declaration 
24-6 (ENTRY) 
24-8 externally referenced symbol 
24-2 declaration (EXTRN) 
Program start (START) directive 
25-1 
25-11 
Program status word (PSW) 
25-9 
Protection program exception 
25-4 
PSW 
25-3 
PUNCH directive 
25-7 example 
format 
function 





Punched card codes 


Punctuation marks, coding 


R 


Reading instruction notation 
assembler application instruction 
rules and meanings 


REC statement 
format 
function 
operational consideration 


Register instruction equate 
instruction 


Register notations, example 
Relational operators 


Relative addressing, location 
counter 


Relocatability attribute 


Reference 


19.1 
19.2 
19.3 


19.4 


19.5 


See START 
directive. 


See PSW. 
Appendix D 
8.1 

21.4 

21.4 


21.4 


Table B-3 


4.1.1 
4.1.2 


F.2.2 
F.2.2 
F.2.2 
6.1 

4.1.2 


43.3 


424 


4.2.3 


B-3 


4-6 
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Term Reference Page Term Reference Page & 
Relocatable expression Scale attribute 
absolute terms 4.4.2 4-17 example 27.5.3 27-28 
definition 4.4.2 4-17 function 27.5.3 27-28 
examples 4.4.2 - 
relocatable term 4.4.2 4-17 SD instruction 
requirements 4.4.2 4-17 example 11.36 11-76 
formats 11.36 11-75 
Relocatable term function 11.36 11-75 
absolute expression 4.4.1 4-16 operational considerations 11.36 11-76 
division 44 4-15 
expression 44 -15 SDR instruction 
multiplication 44 4-15 example 11.37 11-78 
formats 11.37 11-77 
Repetitive code generation statements function 11.37 11-77 
conditional assembly control operational considerations 11.37 11-77 
counter (ACTR) 27.4.3 27-23 
define end of range (ENDO) 27.4.2 27-22 SDT 
define start of range (DO) 27.4.1 27-21 binary conversion 4.2.1 4-9 
character 4.2.1 4-10 
REPRO directive decimal 4.2.1 4-9 
example 21.3 21-5 hexadecimal 4.2.1 4-9 
format 21.3 21-5 meaning 4.2 4-8 
function 21.3 21-5 4.2.1 4-9 
negative term 4.2.1 4-9 
Reproduce following record use 421 4-9 
(REPRO) directive See REPRO 
directive. SE instruction & 
example 11.38 11-80 
RR instruction 7.1 7-1 formats 11.38 11-79 
function 11.38 11-79 
RS instruction 7.1 7-1 operational considerations 11.38 11-80 
Running an assembler program Self-defining terms (SDT) See SOT. 
examples 29.6.1 29-17 
using job control 29.1 29-1 SEQ statement 
format F.2.1 F-6 
RX instruction 7.1 7-1 function F.2.1 F-6 
operational considerations F.2.1 F-6 
specifications F.2.1 F-6 
Ss 
Sequence field, coding form 1.1 1-8 
S instruction 
example 10.21 10-57 Sequence symbols 27.2.1 27-14 
formats 10.21 10-56 
function 10.21 10-56 SER instruction 
operational considerations 10.21 10-56 example 11.39 11-82 
formats 11.39 11-81 
S switch, ED instruction 9.6 9-16 function 11.39 11-81 
operational considerations 11.39 11-81 
S, type constant 5.2.10 5-13 


Service timer register 
Sample program Appendix A (STR) instruction 13.5.1 13-12 
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Term 


Set program mask (SPM) 
instruction 


SET statement 
examples 
format 
function 


operator priority 
Set storage key (SSK) instruction 


SET symbols 
character expressions 
function 
global 
local 
SET statement 
SETA statement 
SETB statement 
SETC statement 
subscripted 
value assignment 


Set system mask (SSM) instruction 


SETA statement 
examples 
format 
function 


SETB statement 
examples 
format 
function 


SETC statement 
examples 
format 
function 


Setting of UPSI byte 


SH instruction 
examples 
formats 
function 
operational considerations 


Shaded option 
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Reference 


See SPM 
instruction. 


27.1.4 
27.1.4 
27.1.3 
27.14 
Table 27-2 


13.2.5 


27.1.8 
27.1 

27.1.2 
27.1.1 
27.1.4 
27.1.5 
27.1.6 
27.1.7 
27.1.9 
27.1.3 


13.2.6 


27.1.5 
27.1.5 
27.1.5 


27.1.6 
27.1.6 
27.1.6 


27.1.7 
27.1.7 
27.1.7 


29.5.4 
10.23 
10.23 
10.23 
10.23 


4.1.2 


Page 


13-6 


27-13 
27-2 
27-4 
27-3 
27-6 
271-9 
27-10 
27-12 
27-13 
27-6 


13-7 


27-10 
27-9 
27-9 


27-12 
27-10 
27-10 


27-13 
27-12 
27-12 


29-16 


10-62 
10-61 
10-61 
10-62 





Term 


Shift left double (SLDA) 
instruction 


Shift left double logical (SLDL) 
instruction 


Shift left single (SLA) 
instruction 


Shift left single logical 
(SLL) instruction 


Shift right double (SRDA) 
instruction 


Shift right double logical (SRDL) 
instruction 


Shift right single logical (SRL) 
instruction 


Shift right single (SRA) 
instruction 


SI. instruction 


Sign consideration for operand 2, 


ED instruction 


Signed unpacked number 


Significance, program exception 


Significance start byte, ED 
instruction 


SIO instruction 


SKI statement 
format 
function 
operational considerations 
specifications 


Index 23 


Reference Page 


See SLDA 
instruction. 


See SLDL 
instruction. 


See SLA 
instruction. 


See SLL 
instruction. 


See SRDA 
instruction. 


See SRDL 
instruction. 


See SRL 
instruction. 


See SRA 
instruction. 


7.1 7-1 


9.6.1 9-16 


See zoned 
decimal constants. 


Appendix D 


9.6 9-16 


13.3.1 13-8 


F.2.3 F 
F.2.3 F- 
F.2.3 F 
F.2.3 F 
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Term 


SL instruction 
example 
formats 
function 
operational considerations 


SLA instruction 
example 
formats 
function 
operational considerations 


SLDA instruction 
example 
formats 
function 
operational considerations 


SLDL instruction 
example 
formats 
functions 
operational considerations 


SLL instruction 
example 
formats 
function 
operational considerations 


SLM instruction 
example 
format 


SLR instruction 
example 
formats 
function 
operational considerations 


SOFTSCOPE forward scan (SSFS) 
instruction 


SOFTSCOPE reverse scan (SSRS) 
instruction 


Source cards 
definition 
general 


Source code 
literals 
PROC (DO loop) 
PROC (positional parameter 0) 


Reference 


14.3.6 
14.3.6 
14.3.6 
14.3.6 


14.2.8 
14.2.8 
14.2.8 
14.2.8 


14.2.7 
14.2.7 
14.2.7 
14.2.7 


14.3.4 
14.3.4 
14.3.4 
14.3.4 


12.21 
12.21 
12.21 
12.21 


3.6.1 
3.6.1 


14.3.7 
14.3.7 
14.3.7 
14.3.7 


13.4.2 


13.4.3 


4.1.2 
Ll 


4.2.2 
30.2 
30.1 
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14-49 
14-48 
14-48 
14-49 


14-27 
14-25 
14-25 
14-26 


14-24 
14-22 
14-22 
14-22 


14-43 
14-42 
14-42 
14-43 


12-58 
12-57 
12-57 
12-57 


13-13 
13-13 


14-52 
14-51 
14-51 
14-51 


13-10 


13-11 


4-10 
30-2 
30-1 
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Term 


Source deck 
definition 
job control cards 
requesting an assembly 


Source deck introduction 
JOB control statement 
OPTION job control statement 


Source module correction routine 
control statements 
correction deck 
REC statement 
SEQ statement 
SKI statement 


Source program 
general 
meaning 


SP. instruction 
examples 
formats 
function 
operational considerations 


SPACE directive 
examples 
format 
function 


Special characters 
Special letters 
Specification, program exceptions 


Specify location counter 
(ORG) directive 


SPM instruction 
example 
formats 
function 
operational considerations 


SR instruction 
examples 
format 
function 
operational considerations 


SRA instruction 
examples 
formats 
function 
operational considerations 


Index 24 


Reference 


4.1.2 
29.5 
29.6 


29.2.1 
29.2.2 


F.2 
F.2 
F.2.2 
F.2.1 
F.2.3 


1.2 
4.1.2 


9.13 
9.13 
9.13 
9.13 


20.3 
20.3 
20.3 


2.4.4 
2.4.2 


Appendix D 


See ORG 
directive. 


13.7 
13.7 
13.7 
13.7 


10.22 
10.22 
10.22 
10.22 


14.2.10 
14.2.10 
14.2.10 
14.2.10 


Page 


4-6 
29-15 
29-17 


9-45 
9-44 
9-44 
9-44 


13-15 
13-15 
13-15 
13-15 


10-59 
10-58 
10-58 
10-58 


14-33 
14-3] 
14-31 
14-32 
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Term 


SRDA instruction 
examples 
formats 
function 
operational considerations 


SRDL instruction 
example 
formats 
function 
operational considerations 


SRL instruction 
example 
formats 
function 
operational considerations 


SS instruction 

SSFS instruction 
SSK instruction 
SSM instruction 
SSRS instruction 


SSTM instruction 
example 
formats 


ST instruction 
example 
formats 
function 
operational considerations 


START directive 
examples 
format 
function 


Start 1/0 (SIO) instruction 


Start-of-data job control 
statement (/$) 


Status switching instructions 
general discussion 
set program mask (SPM) 
supervisor call (SVC) 
test and set (TS) - featured 


STC instruction 
example 
formats 
function 
operational considerations 





SPERRY UNIVAC OS/3 Index 25 
ASSEMBLER 
Reference Page Term Reference Page 
STD instruction 
14.2.9 14-29 example 11.40 11-84 
14.2.9 14-28 formats 11.40 11-83 
14.29 14-28 function 11.40 11-83 
14.29 14-29 operational considerations 11.40 11-83 
STE instruction 
14.3.5 14-46 example 11.41 11-86 
14.3.5 14-45 formats 11.41 11-85 
14.35 14-45 function 11.41 11-85 
14.3.5 14-46 operational consideration 11.41 11-85 
STH instruction 
12.22 12-61 example 10.19 10-52 
12.22 12-60 formats 10.19 10-51 
12.22 12-60 function 10.19 10-51 
12.22 12-60 operational considerations 10.19 10-51 
7.1 7-1 STM instruction 
examples 10.20 10-54 
13.4.2 13-10 formats 10.20 10-53 
function 10.20 10-53 
13.2.5 13-6 operational considerations 10.20 10-54 
13.2.6 13-7 Storage, type characteristics Table 5-1 5-2 
13.4.3 13-11 Store (ST) instruction See ST 
instruction. 
13.6.2 13-14 Store, long format (STD) 
13.6.2 13-14 instruction See SID 
instruction. 
10.18 10-50 Store, short format (STE) 
10.18 10-49 instruction See STE 
10.18 10-49 instruction. 
10.18 10-49 
Store character (STC) instruction See STC 
175 instruction. 
17.5 ~ ; : 
Store half word (STH) instruction See STH 
17.5 17-8 ; 
instruction. 
13.3.1 13-8 : 
Store multiple (STM) instruction See STM 
instruction. 
29.4 29-15 
STR instruction 13.5.1 13-12 
13.1 13-1 SU instruction 
13.7 13-15 example 11.42 11-88 
13.8 13-17 formats 11.42 11-87 
13.9 13-19 function 11.42 11-87 
operational considerations 11.42 11-87 
12.23 12-63 
12.23 12-62 
12.23 12-62 
12.23 12-62 
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Term 


Subparameters 


referencing in the call (macro) 


referencing in the call (proc) 
Subroutine linkage 
Subscripted SET symbols 


Subtract (S) instruction 


Subtract decimal (SP) instruction 


Subtract half word (SH) 
instruction 


Subtract logical (SL) instruction 


Subtract logical (SLR) instruction 


Subtract normalized, tong format 
(SD) 


Subtract normalized, long format 
(SDR) instruction 


Subtract normalized, short 
format (SE) instruction 


Subtract normalized, short 
format (SER) instruction 


Subtract (SR) instruction 


Subtract unnormalized, long format 
(SW) instruction 


Subtract unnormalized, long format 
(SWR) instruction 


Subtract unnormalized, short 
format (SU) instruction 


Subtract unnormalized, short 
format (SUR) instruction 


Reference 


26.4 


25.4 


19.6 


27.1.9 


See §$ 


instruction. 


See SP 


instruction. 


See SH 


instruction. 


See SL 


instruction. 


See SLR 


instruction. 


See SD 


instruction. 


See SDR 


instruction. 


See SE 


instruction. 


See SER 


instruction. 


See SR 


instruction. 


See SW 


instruction. 


See SWR 


instruction. 


See SU 


instruction. 


See SUR 


instruction. 
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Supervisor call (SVC) 
26-5 instruction 
25-7 


19-11 Supervisor load multiple (SLM) 


instruction 
27-13 


Supervisor store multiple (SSTM) 


instruction 


SUR instruction 
example 
formats 
function 


operational considerations 


SVC instruction 
example 
formats 
function 


operational considerations 


SW instruction 
example 
formats 
function 


operational considerations 


SWR instruction 
example 
formats 
function 


Operational considerations 


Symbol 
applications 
definition 


equivalent 
invalid examples 
valid examples 


values 


Symbol attributes 
length 
relocatability 
value 


System variable symbols 
&SYSDATE 
&SYSECT 
&SYSIDATE 
&SYSLIST 
&SYSNDX 
&SYSPARM 
&SYSTIME 
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Reference 


See SVC 
instruction. 
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13.6.2 


11.43 
11.43 
11.43 
11.43 


13.8 
13.8 
13.8 
13.8 


11.44 
11.44 
11.44 
11.44 


11.45 
11.45 
11.45 
11.45 


6.2 

4.2.3 
Section 6 
6.2 

6.1 

4.2.3 

6.1 

4.2.3 


4.2.3 
4.2.3 
4.2.3 


G.4 
G1 
6.6 
G.2 
6.3 
G.7 
G.5 
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13-14 


11-90 
11-89 
11-89 
11-89 


13-17 
13-17 
13-17 
13-17 


11-92 
11-91 
11-91 
11-91 


11-94 
11-93 
11-93 
11-93 
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T U 
Terminate-the-card-reader job Unassign base register (DROP) 
contro! statement (//FIN) 29.5.3 29-16 directive See DROP 
directive. 
Terms 
classes 4.2 4-8 Unconditional branch (AGO) 
comparison Table 4-1 4-9 statement See AGO 
statement. 
Test and set (TS) instruction See TS 
instruction. Unpack decimal (UNPK) instruction See UNPK 
instruction. 
Test under mask (7M) instruction See TM 
instruction. Unpacked format, numeric 
representation 2.4.3.1 2-6 
TITLE directive 
examples 20.4 20-6 UNPK instruction 
format 20.4 20-6 examples 9.14 9-48 
function 20.4 20-6 formats 9.14 9-47 
function 9.14 9-47 
TM instruction operational considerations 9.14 9-48 
examples 12.24 12-66 
formats _ 12.24 12-64 Uppercase letters and terms, 
function 12.24 12-64 coding 4.1.2 4-6 
operational considerations 12.24 12-65 
& UPSI byte, setting 29.5.4 29-16 
TR instruction 
example 12.25 12-68 USING directive 
formats 12.25 12-67 examples 18.2 18-4 
function 12.25 12-67 format 18.2 18-3 
operational considerations 12.25 12-68 function 18.2 18-3 
translate operation 12.25 12-67 
Translate (TR) instruction See TR 
instruction. 
Translate and test (TRT) V 
instruction See TRT 
instruction. V, type constant 5.2.11 5-14 
TRT instruction Value attribute 4.2.3 4-11 
example 12.26 12-72 
formats 12.26 12-70 
function 12.26 12-70 
operational considerations 12.26 12-71 
TS instruction WwW 
examples 13.9 13-19 
formats 13.9 13-19 Word structure, example Fig. 4-2 4-] 
function 13.9 13-19 


operational considerations 13.9 13-19 Writing conventions 1.1 1-1 
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X instruction 
example 
formats 
function 
operational considerations 


X, type constant 


XC instruction 
example 
formats 
function 
operational considerations 


XI instruction 
examples 
formats 
function 
operational considerations 


XOR, bit comparison 


XR instruction 
example 
formats 
function 
operational considerations 


Reference 


12.10 
12.10 
12.10 
12.10 


5.2.2 


12.1] 
12.11 
12.11 
12.11 


12.12 
12.12 
12.12 
12.12 


43.2 


12.13 
12.13 
12.13 
12.13 
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12-29 
12-27 
12-27 
12-28 


5-9 


12-31 
12-30 
12-30 
12-31 


12-35 
12-33 
12-33 
12-34 


4-14 


12-37 
12-36 
12-36 
12-37 
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Y, type constant 


Z, constant 


ZAP instruction 
examples 
formats 
function 
operational considerations 


Zero and add (ZAP) instruction 


Zero result 
AD instruction 
ADR instruction 
AE instruction 
AER instruction 


Zone field 


Zoned decimal constants (Z) 
function 
padding 
truncating 
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Reference 


5.2.8 


5.2.5 


9.15 
9.15 
9.15 
9.15 


See ZAP 
instruction. 


11.2 
11.3 
11.4 
11.5 


2.4.3.1 


5.2.5 


5.2.5 
5.2.5 


Page 


11-3 
11-6 
11-9 
11-12 


5-10 
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